# quota_exhausted — Shorty API error

> Quota exhausted (HTTP 429): when the Shorty API returns the quota_exhausted error, why, and how to fix it.

| Code | HTTP status | Type URI |
| --- | --- | --- |
| `quota_exhausted` | 429 | `https://aishorty.com/docs/api/errors/quota_exhausted` |

## When it happens

A plan usage quota (shared across the app, MCP, and API) is used up for its period — e.g. the free MONTHLY subtitle allowance, the free daily API summary quota, or the free monthly API transcription quota.

## Example response

```json
{
  "type": "https://aishorty.com/docs/api/errors/quota_exhausted",
  "title": "Quota exhausted",
  "status": 429,
  "detail": "Your quota for this resource is exhausted.",
  "instance": "urn:request:req_01J9Z8ABCDEFGH0123456789",
  "code": "quota_exhausted",
  "request_id": "req_01J9Z8ABCDEFGH0123456789"
}
```

## How to fix it

Wait for the quota period to reset, or upgrade the plan for a higher allowance. Quota is product-level, so app and API usage count against the same pool.

## Related errors

- [rate_limited](/docs/api/errors/rate_limited) — Rate limit exceeded (HTTP 429)
- [feature_not_enabled](/docs/api/errors/feature_not_enabled) — Feature not enabled (HTTP 403)