---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/reference/GetReportList.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetReportList.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# GetReportList
Возвращает список сформированных и формируемых отчетов о статистике кампании.
Метод используют для проверки готовности отчета с интересующим идентификатором. Также с помощью метода получают идентификатор отчета, чтобы затем удалить отчет с помощью метода [DeleteReport](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/DeleteReport.md).

## Ограничения

Вызывать метод рекомендуется не чаще одного раза в 10-20 секунд (формирование отчета занимает в среднем одну-две минуты). Когда отчет готов, метод возвращает ссылку для скачивания файла с сервера.


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON. Метод не имеет входных параметров.

```javascript
{
   "method": "GetReportList"
}
```


## Результирующие данные {#output}

Метод возвращает массив объектов `ReportInfo`, каждый из которых содержит сведения об одном отчете. Всего в массиве может присутствовать до пяти объектов. Массив отсортирован по убыванию `ReportID`.

Ниже показана структура результирующих данных в формате JSON.

```javascript
{
   "data": [
      {  /* ReportInfo */
         "ReportID": (int),
         "Url": (string),
         "StatusReport": (string)
      }
      ...
   ]
}
```

Ниже приведено описание параметров.


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
||

||
**<sub >Объект ReportInfo</sub>**
||
||
`ReportID`
|
Идентификатор отчета о статистике кампании.
||
||
`Url`
|
Ссылка для скачивания отчета с сервера. Если формирование отчета не завершено, возвращается пустая строка. Отчет доступен по протоколу HTTPS.
||
||
`StatusReport`
|
Состояние отчета:

- Done — отчет сформирован;
- Pending — отчет формируется;
- Failed — сформировать отчет не удалось.
||
|#