---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.com/dev/adfox/doc/en/rest-statistics/getting-reports.md
  - https://yandex.com/dev/adfox/doc/ru/rest-statistics/getting-reports.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/adfox/doc/ru/llms.txt

# Получение отчетов

В Adfox есть предзаданные отчеты (далее — `fixed`), которые предоставляются платформой и доступны партнерам, а также есть возможность с помощью конструктора отчетов собрать и сохранить собственный отчет в интерфейсе (далее — `custom`).

Получение отчета состоит из нескольких шагов.

{% list tabs %}

- Предзаданные и собственные отчеты

  Если отчет сохранен — `fixed` или `custom`:

  1. Запросите список отчетов:

     ```http id="n2r5qw"
     GET /api/v2/reports/list
     ```

  1. Получите параметры отчетов (только для `custom`, для `fixed` список полей не вернет):

     ```http
     GET /api/v2/reports/report-info/{reportName}
     ```

  1. Получите доступный период:

     ```http
     GET /available-dates
     ```

  1. Отправьте запрос на формирование отчета и сохраните `result.taskId`:

     ```http
     POST /api/v2/reports/{reportName}
     ```

- Сформировать отчет по API

  1. Получите и закэшируйте списки `dimensions`, `metrics`, `filters` и `limits`:

     ```http
     GET /metadata
     ```

  1. При необходимости получите доступные даты для отчета:

     ```http
     GET /available-dates
     ```

  1. Отправьте запрос с валидным телом и сохраните `result.taskId`:

     ```http
     POST /reports
     ```

{% endlist %}

Далее:

1. Выполняйте цикл запросов до получения одного из статусов:

   * `SUCCESS`
   * `FAILURE`
   * `EXPIRED`

    ```http id="c7z4nt"
    GET /reports/{taskId}
    ```

2. Используйте таймаут перед повторным запросом.

3. При статусе `SUCCESS` получите результат отчета:

   ```http id="v0l3jd"
   GET /reports/{taskId}/result
   ```