> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinakelai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monthly quota exceeded

> HTTP 429, quota-exceeded. The key has used its monthly quota.

| | |
| - | - |
| Type | `https://docs.pinakelai.com/errors/quota-exceeded` |
| Status | 429 |
| Retry | Only after the quota resets. |

## When it happens

The key's calls this UTC calendar month reached its monthly quota (`violated_policies: ["month"]`). The quota counts calls to every product the key carries.

## What to do

Wait until the next month starts (the `RateLimit` header's `t` for `month` gives the seconds), or contact [hello@pinakelai.com](mailto:hello@pinakelai.com) to raise the quota. Check usage with [`GET /v1/usage`](https://docs.pinakelai.com/api-reference/account/usage).

## Example

```http Headers theme={null}
HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Policy: "minute";q=600;w=60, "month";q=100000;w=2592000
RateLimit: "minute";r=412;t=33, "month";r=0;t=1555200
```

```json Body theme={null}
{
  "type": "https://docs.pinakelai.com/errors/quota-exceeded",
  "title": "Monthly quota exceeded",
  "status": 429,
  "detail": "This key has used its monthly quota of 100000 calls.",
  "request_id": "req_01M7Q40STVWXYZ0123456789AB",
  "violated_policies": [
    "month"
  ]
}
```

See the [errors catalogue](https://docs.pinakelai.com/api-reference/errors.md) for every error type, and [Handling errors](https://docs.pinakelai.com/guides/errors.md) for retry strategy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.