# Request Limit

### Request Limit Policy <a href="#undefined" id="undefined"></a>

Request limit refers to the limit on the number of API calls per unit of time. DFINERY applies the request limit policy to all Open APIs it provides to ensure stable service operation.

| Classification                                           | Rate Limit (Default)                         |
| -------------------------------------------------------- | -------------------------------------------- |
| [Event](/api-guide/en/api/import-api/event-api.md)       | 1,000,000 per minute                         |
| [Identity](/api-guide/en/api/import-api/identity-api.md) | 10,000 per minute                            |
| [Profile](/api-guide/en/api/import-api/profile.md)       | 10,000 per minute                            |
| [Export](/api-guide/en/api/export-api/export.md)         | 100 cases per hour, 5 cases at the same time |

{% hint style="danger" %}
If the request limit is exceeded, all subsequent API requests will fail. After the time limit has elapsed and the request limit is reset, you can receive a normal response. It is recommended to consider the request limit when linking APIs.
{% endhint %}

{% hint style="info" %}
If you need to make more calls than the default request limits, please contact our Customer Success team.
{% endhint %}

## Check request limit status

Request limit status can be checked through the value of the response header.

| Header Name                  | Explanation                                       |
| ---------------------------- | ------------------------------------------------- |
| **`X-Rate-Limit-Limit`**     | Initialization cycle                              |
| **`X-Rate-Limit-Remaining`** | Number of requests remaining                      |
| **`X-Rate-Limit-Reset`**     | Time for the transmission speed to be initialized |

{% hint style="info" %}
**X-Rate-Limit-Limit** consists <kbd>1Y: 1 year, 1M: 1 month, 1D: 1 day, 1H: 1 hour, 1M: 1 minute, 1S: 1 second</kbd> of .

**X-Rate-Limit-Rest** is in Timestamp format.`1719397769`
{% endhint %}

### Example of a request limit status response <a href="#undefined-2" id="undefined-2"></a>

#### Normal response <a href="#undefined-3" id="undefined-3"></a>

```shell
curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 200
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 99999
> x-ratelimit-reset: 1682593200268
```

### If the API call limit is exceeded (response code 429)

```shell
curl -i https://openapi.dfinery.ai/api/v1/...
> HTTP/2 429
> x-ratelimit-limit: 1d
> x-ratelimit-remaining: 0
> x-ratelimit-reset: 1682640000000
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dfinery.ai/api-guide/en/rate-limit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.