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

# Acceptable reporting periods

<!-- source: en/_includes/notes.md -->
{% note info %}

Report data is stored for 3 years.

{% endnote %}
<!-- endsource: en/_includes/notes.md -->

To find out the acceptable periods for building a report, you need to send two requests.

1. Using the first request, you need to find out which parameters affect the period for the selected level of detail:
   
   ```httpget
   https://adfox.yandex.com/api/report/date/argument/list/<level>
   ```
   
   #### Request parameters
   
   #|
   || **Parameter** | **Description** ||
   || 
   `level` 
   | [The level of detail](*level).
 ||
   |#
   
   #### Response format
   
   The response is an array of parameter names.
       
   #### Response example
   
   ```no-highlight
   {
       "result": [
           "supercampaignId"
       ],
       "error": null
   }
   ```
       
1. The received parameters must be passed to the second request in order to get acceptable periods:
   
   ```httpget
   https://adfox.yandex.com/api/report/date/interval/<level>?<arguments>
   ```
   
   #### Request parameters
   
   #|
   || **Parameter** | **Description** ||
   || 
   `level` 
   | [The level of detail](*level).
 ||
   || 
   `arguments` | The parameters that you received in response to your first request with values. ||
   |#
   
   #### Response format
   
   ```no-highlight
   {
     "result":{
         "dateFrom": (string)
         "dateTo": (string)
     },
     "error": (string)
   }
   ```
   
   #|
   || **Parameter** | **Description** ||
   || 
   `dateFrom` | The date in `YYYY-MM-DD` format, starting from which you can build a report. ||
   || 
   `dateTo` | The date in the `YYYY-MM-DD` format, up to which data for building the report are available. ||
   |#
   
   
   #### Sample request
   
   ```no-highlight
   https://adfox.yandex.com/api/report/date/interval/owner?name=devicesTypes
   ```
   
   #### Response example
   
   ```no-highlight
   {
       "result":{
           "dateFrom": "2019-07-09",
           "dateTo": "2022-04-17"
       },
       "error": null
   }
   ```

[*level]: Available levels of detail:

- `owner`: A general report.
- `supercampaign`: At the supercampaign level.
- `campaign`: At the campaign level.
- `banner`: At the banner level.
- `site`: At the site level.
- `section`: At the section level.
- `place`: At the placement level.