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

# Запрос на формирование отчета

Одновременно в работе могут находиться не больше 3 отчетов.

## Получение отчетов {#predefined-reports}

Для формирования отчета выполните запрос:

```httpget
https://adfox.yandex.ru/api/report/<level>?name=<report_name>&<arguments>
```

#### Параметры запроса

#|
|| **Параметр** | **Описание** ||
|| 
`level` 
| [Уровень детализации](*level) отчета.
 ||
|| 
`report_name` 
| Название отчета (используется при запросе). Можно узнать с помощью метода [list](https://yandex.ru/dev/adfox/doc/ru/statistics/methods/reports-list.md).
 ||
|| 
`arguments` | Аргументы, [необходимые](https://yandex.ru/dev/adfox/doc/ru/statistics/methods/report-arguments.md) для формирования данного отчета, со значениями. Полный список аргументов представлен в разделе [Аргументы для построения отчета](https://yandex.ru/dev/adfox/doc/ru/statistics/how-to.md#arguments). ||
|#

Чтобы построить отчет по нескольким объектам, передайте список ID в виде массива JSON. Пример запроса для кампании:

```httpget
https://adfox.yandex.ru/api/report/campaign?name=days&dateFrom=2022-04-28&dateTo=2022-04-29&campaignId=[1891306,1891313,1891312,1860311]
```

#### Формат ответа

Запрос возвращает ID задачи `taskId` на формирование отчета. ID задачи нужен для [получения готового отчета](https://yandex.ru/dev/adfox/doc/ru/statistics/methods/get-report.md).

```
{
  "result": {
      "taskId": ()
  },
  "error": <errorCode>
}
```
    
{% note info %}
    
По полученному `taskId` можно получать данные в течение часа.
    
{% endnote %}

[*level]: Доступные уровни детализации:

- `owner` — общий отчет;
- `supercampaign` — на уровне суперкампании;
- `campaign` — на уровне кампании;
- `banner` — на уровне баннера;
- `site` — на уровне сайта;
- `section` — на уровне раздела;
- `place` — на уровне рекламного места.