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

# Rate limits

> Per-partner token-bucket limits and how to handle 429s.

Requests are rate-limited per partner, per endpoint class, per scope, using a
token bucket.

| Endpoint class         | Per second | Per minute |
| ---------------------- | ---------- | ---------- |
| `read` (all endpoints) | 60         | 1,000      |

The limiter is checked **before** authentication, so repeated unauthenticated
attempts still consume your budget — a deliberate abuse guard.

## Handling 429

When you exceed the budget you get [`partner_rate_limited`](/errors/partner_rate_limited)
with HTTP `429` and a `retry_after_seconds` hint:

```json theme={null}
{
  "error": {
    "code": "partner_rate_limited",
    "message": "rate limit exceeded",
    "retry_after_seconds": 0.42
  }
}
```

Back off for at least `retry_after_seconds` and retry the same request (reads are
idempotent and carry only the Bearer header, so you can simply resend). Prefer the
paginated `GET /fleet` over polling individual crew where you can — one fleet page
covers your whole vessel roster in a single call.