# 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](https://docs.dfinery.ai/api-guide/en/api/import-api/event-api)       | 1,000,000 per minute                         |
| [Identity](https://docs.dfinery.ai/api-guide/en/api/import-api/identity-api) | 10,000 per minute                            |
| [Profile](https://docs.dfinery.ai/api-guide/en/api/import-api/profile)       | 10,000 per minute                            |
| [Export](https://docs.dfinery.ai/api-guide/en/api/export-api/export)         | 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
```