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

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


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

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

```javascript
{
   "method": "GetForecastList"
}
```


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

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

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

```javascript
{
   "data": [
      {  /* ForecastStatusInfo */
         "ForecastID": (int),
         "StatusForecast": (string)
      }
      ...
   ]
}
```

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


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

||
**<sub >Объект ForecastStatusInfo</sub>**
||
||
`ForecastID`
|
Идентификатор отчета.
||
||
`StatusForecast`
|
Состояние отчета:

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