---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/dev/developer-help/doc/en/api/get-statistics.md
  - https://yandex.com/dev/developer-help/doc/ru/api/get-statistics.md
  - https://yandex.com/dev/developer-help/doc/tr/api/get-statistics.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/developer-help/doc/en/llms.txt

# Project statistics

The request lets you get statistics about requests to the API over a period of time. The maximum period per request is 35 days. Usage frequency limit: 1 request in 10 seconds.

## Request format {#request-format}

To get project statistics, use an HTTP request with the `GET` method:

```text
GET /projects/[<project_id>](*popap_2)/services/[<service_id>](*popap_3)/statistic?[start](*popap_4)=<YYYY-MM-DD>&[end](*popap_5)=<YYYY-MM-DD>
[Host](*popap): api-developer.tech.yandex.net
[X-Auth-Key](*popap_1): <your API key>
```

{% cut "Resource" %}

**<project_id>**

Project ID.

**<service_id>**

Service ID.

**start**

The start date of the period.

**end**

The end date of the period.

{% endcut %}

{% cut "Request headers" %}

**Host**

The URL of the node providing the API.

**X-Auth-Key**

[Authorization](https://yandex.com/dev/developer-help/doc/en/api/auth.md) key.

{% endcut %}

## Response format {#response-format}

{% list tabs %}

- The request has been completed successfully

  If the request has been completed successfully, the API returns a response with the code 200. The response body contains an object in JSON format:
  
  ```json
  {
      "statistic": [
          {
              "counters": {
                  "cells": 50,
                  "orders": 10,
                  "requests": 2,
                  "requests_router": 8,
                  "total": 10
              },
              "date": "2021-10-01"
          },
          {
              "counters": {
                  "cells": 43,
                  "orders": 15,
                  "requests": 4,
                  "requests_router": 9,
                  "total": 13
              },
              "date": "2021-10-02"
          },
          ...
      ]
  }
  
  ```
  
  #### Response properties

  #|
  || **Key** | **Value** ||
  || `statistic` | Array with statistics by day. ||
  || The properties of the `statistic` array ||
  || `counters` | An object with names and values of counters per day. ||
  || `date` | Date. ||
  |#

- The request has been executed with an error

  If the request has failed, the response message contains information about errors:

  #|
  || **HTTP error code** | **Error description** ||
  || `400 Bad Request` | One of the request parameters has an invalid value or data format. ||
  || `403 Forbidden` | The user or app does not have rights to access the resource; the request is rejected. ||
  || `404 Not Found` | The requested resource is not found. ||
  || `500 Internal Server Error` | Internal service error. Try resending your request later. ||
  || `503 Service Unavailable` | The API service is temporarily unavailable. ||
  |#

{% endlist %}

[*popap]:
 
The URL of the node providing the API.

[*popap_1]:
 
Authorization key.

[*popap_2]:
 
Project ID.

[*popap_3]:
 
Service ID.

[*popap_4]:
 
The start date of the period.

[*popap_5]:
 
The end date of the period.