---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/how-to.md
  - https://yandex.com/dev/direct/doc/ru/how-to.md
  - href: ru/how-to.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/reports/how-to.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# Как сформировать отчет

1. Выполните запрос к сервису `Reports`.
    
    В HTTP-заголовке `Authorization` укажите OAuth-токен, полученный для пользователя, по кампаниям которого требуется получить статистику. Полный список заголовков приведен в разделе [HTTP-заголовки](https://yandex.com/dev/direct/doc/ru/headers.md).
    
    В теле запроса укажите значения основных параметров в зависимости от того, какие данные вам нужны:
    
    - за какой [период](https://yandex.com/dev/direct/doc/ru/period.md) требуется получить отчет и по каким периодам нужно агрегировать данные;
    
    - какой [тип отчета](https://yandex.com/dev/direct/doc/ru/type.md) подходит для вашей задачи;
    
    - какие [поля](https://yandex.com/dev/direct/doc/ru/fields.md) (столбцы) необходимо выводить в отчете;
    
    - в каком виде следует выводить [денежные значения](https://yandex.com/dev/direct/doc/ru/money.md);
    
    - какие [фильтры](https://yandex.com/dev/direct/doc/ru/filters.md) будут использоваться для отбора данных.
    
    Полный список входных параметров представлен в разделе [Запрос: спецификация отчета](https://yandex.com/dev/direct/doc/ru/spec.md).
    
1. Отчеты с небольшим количеством данных формируются в режиме онлайн. В этом случае вы сразу получите HTTP-код ответа 200, а отчет будет передан в теле ответа.
    
    Отчеты с большим количеством данных, а также некоторые типы отчетов формируются в режиме офлайн. В этом случае вы получите HTTP-код ответа 201.
    
    Подробная схема запросов и ответов приведена в разделе [Онлайн- и офлайн-отчет](https://yandex.com/dev/direct/doc/ru/mode.md).
    
1. Чтобы получить отчет, который формируется в режиме офлайн, повторите запрос с теми же параметрами через некоторое время.
    
    Если формирование отчета еще не завершено, вы получите HTTP-код ответа 202.
    
    Если отчет готов, вы получите HTTP-код ответа 200, а отчет будет передан в теле ответа.
    

Пример запроса и пример отчета представлен в разделе [Пример: клики и стоимость](https://yandex.com/dev/direct/doc/ru/example.md).