---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/api360/doc/ru/statistics/get-user-statistics-export.md
  - href: ru/statistics/get-user-statistics-export.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: docs/dev/api360/concepts/gw/statistics/get-user-statistics-export.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/api360/doc/ru/llms.txt

# Выгрузить статистику по пользователям (CSV)

Возвращает CSV-файл со статистикой использования продуктов Яндекс 360 пользователями организации.

В отчете собраны данные за указанный период (от 1 дня до 3 месяцев). Данных за текущий день нет — они станут доступны только завтра.

Максимальный размер файла — 408 666 строк. Чтобы получить больше данных, [выгрузите статистику в формате JSON](https://yandex.ru/dev/api360/doc/ru/statistics/get-user-statistics.md).

{% note info %}

Чтобы выполнить запрос, приложению требуется разрешение на чтение статистики `ya360_data:read_reports`. Убедитесь, что вы включили его при [настройке OAuth-приложения](https://yandex.ru/dev/api360/doc/ru/access.md).

{% endnote %}

## Запрос {#request}

##GET## `https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/users/statistics/export`

### Path-параметры {#path-parameters}

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| org_id **\*** | string | Идентификатор организации. ||
|#

### Query-параметры {#query-parameters}

#|
|| **Имя параметра** | **Тип** | **Описание** ||
|| start_date **\*** | string | Дата, с которой нужно получить данные. Формат: `YYYY-MM-DD`. ||
|| end_date **\*** | string | Дата, по которую нужно получить данные. Формат: `YYYY-MM-DD`. ||
|| format | string | Формат выгрузки данных. По умолчанию `csv`. Доступные значения: `csv`. ||
|#

### Заголовки {#headers}

```json
Authorization: OAuth <токен>
```

### Пример {#example}

{% cut "Пример запроса" %}

```bash
curl \
-f \
--url 'https://disk-1.prestable.cloud-api.dsp.yandex.net/v1/directory/organizations/123456/users/statistics/export?start_date=2026-04-17&end_date=2026-04-17' \
-H "Authorization: OAuth <токен>" \
-O -J
```

Имя итогового файла — `users_statistics_123456_2026-04-17_2026-04-17.csv`. 

Если данных больше лимита (408 666 строк), отчет скачается не полностью. В этом случае к названию добавится префикс `partial_` — `partial_users_statistics_123456_2026-04-17_2026-04-17.csv`.

{% endcut %}

## Ответ {#response}

### Успешный ответ {#successful}

Результатом корректного запроса является ответ с кодом 200 и телом в формате CSV.

`200 OK` — запрос выполнен успешно.

**Содержимое файла:**

CSV файл со статистикой по пользователям организации. Содержит следующие поля:

- `date` — дата, к которой относятся данные;  
- `user_id` — uid пользователя;  
- `nickname` — nickname пользователя;  
- `account_type` — тип аккаунта (`domain`/`portal`/`other`);  
- `name` — имя пользователя;  
- `is_admin` — является ли пользователь администратором;  
- `is_manager` — является ли пользователь менеджером;  
- `is_enabled` — является ли пользователь активным (минимум 1 действие за последние 30 дней);  
- `mail_last_usage_date` — дата последнего использования Почты;  
- `mail_sent_letters_count` — количество отправленных писем;  
- `mail_received_letters_count` — количество полученных писем;  
- `mail_read_letters_count` — количество прочитанных писем;  
- `mail_replied_letters_count` — количество писем с ответами;  
- `disk_last_usage_date` — дата последнего использования Диска;  
- `disk_uploaded_files_count` — количество загруженных файлов на Диск;  
- `disk_file_views_count` — количество просмотров файлов на Диске;  
- `disk_downloaded_files_count` — количество скачиваний файлов с Диска;  
- `messenger_last_usage_date` — дата последнего использования Мессенджера;  
- `messenger_calls_count` — количество звонков в Мессенджере;  
- `messenger_chats_created_count` — количество созданных чатов;  
- `messenger_channels_created_count` — количество созданных каналов;  
- `telemost_last_usage_date` — дата последнего использования Телемоста;  
- `telemost_conferences_count` — количество встреч в Телемосте;  
- `telemost_conferences_created_count` — количество созданных встреч в Телемосте;  
- `telemost_conferences_total_time_minutes` — общее время встреч в Телемосте (в минутах);  
- `telemost_live_streams_created_count` — количество созданных прямых трансляций в Телемосте;  
- `telemost_live_streams_count` — количество прямых трансляций в Телемосте;  
- `telemost_conferences_average_time_minutes` — среднее время встреч в Телемосте (в минутах).

### Неуспешный ответ {#unsuccessful}

Ошибки могут быть со следующими HTTP-статусами:

- `400 Bad Request` — параметры запроса не заданы или заданы неверно;
- `401 Unauthorized` — пользователь не авторизован;
- `403 Forbidden` — у пользователя или приложения нет прав на доступ к статистике;
- `404 Not Found` — запрашиваемая организация не найдена;
- `500 Internal Server Error` — ошибка произошла на стороне сервера.