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

# Rate limits

> Request throughput limits on the Huntr API.

Authenticated endpoints are limited to **5 requests per second** per API key.

## Headers

Successful responses may include rate limit metadata:

```json theme={null}
{
  "rate_limit": {
    "remaining": 27,
    "reset": 1746127200000
  }
}
```

| Field       | Meaning                                    |
| ----------- | ------------------------------------------ |
| `remaining` | Requests left in the current window        |
| `reset`     | Unix timestamp (ms) when the window resets |

## When limited

`429` responses include retry guidance. Back off and retry after the reset time.

## Bulk workflows

When paginating search or enriching many rows:

* Add **200ms+ delay** between calls in scripts
* Use **queue workers** with concurrency caps in production
* **Preview counts** before full pagination

## MCP and agents

Agents can burst tool calls. If you hit `429`, instruct the agent to retry with backoff or serialize Huntr calls.

## Next step

* [Credits and pricing](/concepts/credits-and-pricing)
* [Errors](/reference/errors)