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

# GetWordstatReportList
Returns a list of query statistics reports that have been generated or are being generated.
This method is used for checking whether a report with a certain ID is ready. Using this method, you can also get report IDs in order to delete reports (using the [DeleteWordstatReport](https://yandex.ru/dev/direct/doc/dg-v4/en/reference/DeleteWordstatReport.md) method).

## Restrictions

We don't recommend calling this method too often. On average, generating reports takes about one minute, so repeating calls for checking report status every 10-20 seconds is frequent enough.


## Input data {#input}

The input data structure in JSON is shown below. The method does not have any input parameters.

```javascript
{
   "method": "GetWordstatReportList"
}
```


## Output data {#output}

The method returns an array of `WordstatReportStatusInfo` objects, each of which contains information about a single report. The array can have a total of up to five objects. The array is sorted by decreasing `ReportID`.

The output data structure in JSON is shown below.

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

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
||

||
**<sub >WordstatReportStatusInfo object</sub>**
||
||
`ReportID`
|
ID of a search query statistics report.
||
||
`StatusReport`
|
Report status:

- Done — Report has been generated.
- Pending — Report is in progress.
- Failed — Report was not generated.
||
|#