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 [e-mail] to raise the quota. Check usage with GET /v1/usage.

​

Example

Headers

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

Body

{
  "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 for every error type, and Handling errors for retry strategy.