QUOTA_EXCEEDED
Monthly quota exceeded: Your account used its plan's monthly API request quota (only when paid plans are enabled).
| HTTP status | Retry |
|---|---|
429 |
no |
Where it comes from: Any public endpoint called with a live lh_live_… key, once the account's live requests this calendar month (UTC) reach its plan's monthlyRequests. Test keys and requests without a key never count.
Causes#
- The account made more live API requests this month than its plan includes (see
GET /v1/account/planor the dashboard's Billing page). - A loop or retry storm in your integration is calling the API far more often than intended.
How to fix#
- Check
x-quota-limit/x-quota-remainingon responses andGET /v1/account/planfor usage and the reset time. - Upgrade the plan in the dashboard (Billing); the higher quota applies within a minute of the invoice being paid.
- Cache quotes you show repeatedly and debounce quote requests while a user types an amount.
Example response#
JSON
{
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Monthly quota of 2000000 requests reached; it resets 2026-11-01T00:00:00.000Z",
"requestId": "0d5e1f6a-3b2c-4d1e-8f9a-7b6c5d4e3f21",
"docsUrl": "https://docs.layerhop.com/errors/QUOTA_EXCEEDED"
}
}See Error handling & retries for a retry strategy, and the error catalog for every code.
Last updated