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

# Rate limited

> You sent more requests to this endpoint than your hourly limit allows. HTTP 429, code RATE_LIMITED.

```json theme={null}
{
  "success": false,
  "error": "Rate limit exceeded. Limit: 240 requests per 1 h",
  "limit": 240,
  "remaining": 0,
  "reset": 1763200000000,
  "retryAfter": 1800,
  "code": "RATE_LIMITED",
  "documentationUrl": "https://www.importly.io/docs/errors/rate-limited"
}
```

| Field | Meaning |
| - | - |
| `limit` | Requests allowed per hour on this endpoint |
| `reset` | When the window resets, as Unix time in milliseconds |
| `retryAfter` | Seconds to wait before retrying |

## Reasons and how to fix

### Polling too fast

Status endpoints allow 3,600 requests per hour per job type, about one per second. Poll each job every few seconds, or pass `webhookUrl` and only poll as a fallback. See [webhooks](/docs/webhooks.md).

### Submitting a large batch at once

`POST /import` and `POST /transcribe` allow 240 requests per hour, and the metadata endpoints 1,000 combined. Spread submissions out, and on a `429`, wait `retryAfter` seconds before you continue.

### Watch the headers

Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset`, so you can slow down before you hit the limit. All limits are on [Errors & rate limits](/docs/error-handling.md#rate-limits).


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