---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/reports.md
  - https://yandex.com/dev/direct/doc/ru/reports.md
  - href: en/reports.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/reports/reports.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# Reports service
<shortdesc >This service helps you retrieve statistics for a specific user account in Yandex Direct.</shortdesc>
To request a report, send a POST request over HTTPS.

Specify the report parameters in XML or JSON format in the request body. The XML must conform to the XSD schema located at: [https://api.direct.yandex.com/v501/reports.xsd](https://api.direct.yandex.com/v501/reports.xsd). See the section [Request: report specification](https://yandex.com/dev/direct/doc/en/spec.md).

The report is generated in [TSV](http://www.iana.org/assignments/media-types/text/tab-separated-values) format. See [Report content](https://yandex.com/dev/direct/doc/en/report-format.md).

Data is transmitted in UTF-8 encoding.

The Yandex Direct server can create a report in either online or offline mode, depending on the [HTTP headers](https://yandex.com/dev/direct/doc/en/headers.md), the [report type](https://yandex.com/dev/direct/doc/en/type.md), and the amount of data in the report. See the section [Online and offline reports](https://yandex.com/dev/direct/doc/en/mode.md).

## Address for XML requests {#url}

```httpget translate=no
https://api.direct.yandex.com/v501/reports
```

```httpget translate=no
https://api.direct.yandex.com/v501/reports
```

## Address for JSON requests {#url_1}

```httpget translate=no
https://api.direct.yandex.com/json/v501/reports
```

```httpget translate=no
https://api.direct.yandex.com/json/v501/reports
```