skills/ship24-troubleshooting/references/rate-limits.md

<!-- GENERATED by scripts/generate-references.mjs from data/rate-limits.json. Do not edit; run pnpm generate. -->

# Ship24 API rate limits

Default rate limits per endpoint, enforced per 1-second window.

The response headers give you 2 different sets of rate limit headers `RateLimit-*` and `X-RateLimit-*`. You should choose one set of headers that match your needs.

## Endpoints

| Method | Path | Requests per second |
| --- | --- | --- |
| POST | /trackers | 10 |
| GET | /trackers | 10 |
| POST | /trackers/bulk | 3 |
| POST | /trackers/track | 10 |
| GET | /trackers/{trackerId} | 10 |
| PATCH | /trackers/{trackerId} | 10 |
| GET | /trackers/search/{trackingNumber}/results | 10 |
| GET | /trackers/{trackerId}/results | 10 |
| POST | /trackers/{trackerId}/webhook-events/resend | 1 |
| POST | /tracking/search | 10 |
| GET | /couriers | 1 |

## Response headers

### RateLimit-*

This set of headers is the standardization draft adopted by the IETF.

| Header | Example | Description |
| --- | --- | --- |
| `RateLimit-Limit` | 10 | The total requests allowed for a 1-second window |
| `RateLimit-Remaining` | 9 | The number of requests left for a 1-second window |
| `RateLimit-Reset` | 1 | The delay in seconds before the rate limit is reset |

### X-RateLimit-*

| Header | Example | Description |
| --- | --- | --- |
| `X-RateLimit-Limit` | 10 | The total requests allowed for a 1 second window |
| `X-RateLimit-Remaining` | 9 | The number of requests left for a 1 second window |
| `X-RateLimit-Reset` | 1645507056 | The Unix timestamp when the rate limit will be reset |

### Retry-After

The header `Retry-After` is also available and indicate the delay in seconds before the rate limit is reset. It's equivalent to the `RateLimit-Reset` header.

| Header | Example | Description |
| --- | --- | --- |
| `Retry-After` | 1 | The delay in seconds before the rate limit is reset |