9d39742802
* Update docs/api-reference/v1/introduction.mdx * Update docs/api-reference/v1/authentication.mdx * Update docs/api-reference/v1/errors.mdx * Update docs/api-reference/v1/rate-limit.mdx * Update docs/mint.json --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
44 lines
1.1 KiB
Plaintext
44 lines
1.1 KiB
Plaintext
---
|
|
title: "Rate limits"
|
|
---
|
|
|
|
<Warning>
|
|
**API v1 is deprecated and will be discontinued on February 15, 2026.** Please migrate to [API v2](/api-reference/v2/introduction) as soon as possible.
|
|
</Warning>
|
|
|
|
We limit the number of calls you can make over a certain period of time. Rate limits vary and are specified by the following header in all responses:
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Header</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td>X-RateLimit-Limit</td>
|
|
<td>The maximum number of requests that the consumer is permitted to make.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>X-RateLimit-Remaining</td>
|
|
<td>The number of requests remaining in the current rate limit window.</td>
|
|
</tr>
|
|
<tr>
|
|
<td>X-RateLimit-Reset</td>
|
|
<td>The time at which the current rate limit window resets in UTC epoch seconds.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
When the rate limit is **exceeded**, an error is returned with the status **"429 Too Many Requests"**:
|
|
|
|
```json
|
|
{
|
|
"error": {
|
|
"code": "too_many_requests",
|
|
"message": "Rate limit exceeded",
|
|
}
|
|
}
|
|
```
|