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

# Information about the request limit

The request lets you get information about requests made to the API of Yandex services. The response body contains data about the requests sent and the number of requests that the user is permitted to send per day.

## Request format {#request-format}

To view the parameters for the limit of requests sent to the service API, use an HTTP request with the `GET` method:

```text
GET /projects/[<project_id>](*popap_2)/services/[<service_id>](*popap_3)/limits
[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.

{% endcut %}

{% cut "Request headers" %}

**Host**

The URL of the node providing the API.

**X-Auth-Key**

Authorization 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
  {
      "limits": {
          "pogoda_hits_daily": {
              "limit": 5000,
              "reset_date": "2019-02-06T21:00:00",
              "value": 0
          }
      }
  }
  ```
  
  #### Response properties

  #|
  || **Key** | **Value** ||
  || `limits` | An object with information about the limit. ||
  || The properties of the `limits` object ||
  || `pogoda_hits_daily` | An object with the limit parameters. ||
  || The properties of the `pogoda_hits_daily` object ||
  || `limit` | Allowed number of requests.

  If the service has no request limit, the parameter takes the `-1` value. ||
  || `reset_date` | Date and time when the limit expired. The count of the number of requests is reset on the specified date.

  Data in the format:

  `YYYY-MM-DDThh:mm:ss` ||
  || `value` | The number of requests sent. ||
  |#
  
- 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.