What are the Cartroute API rate limits?
The API allows 120 requests per minute per API key and 30 per minute per IP address for calls without a key. Every response reports the current state in RateLimit-* headers, and a 429 adds Retry-After. Rate-limited calls are never charged.
Which headers report the limit?
| Header | Meaning |
|---|---|
RateLimit-Limit | Requests allowed in the window. |
RateLimit-Remaining | Requests left in the current window. |
RateLimit-Reset | Seconds until the window resets. |
RateLimit-Policy | The policy, e.g. 120;w=60. |
Retry-After | On 429 only: seconds to wait before retrying. |
What should an agent do when limited?
Sleep for Retry-After seconds and resend the same request with the same Idempotency-Key. Do not retry immediately in a loop: every retry inside the window is itself rejected. For planned bursts, pace requests using RateLimit-Remaining instead of waiting to be rejected.
Are there other limits?
POST /api/v1/accounts: five accounts per IP per hour.- Anonymous web searches on cart-route.com: five per visitor per day; logged-in searches use credits instead.
- Request bodies: 32 KB for the REST API, 64 KB for MCP.
Can I get a higher limit?
The Scale plan allows 600 requests per minute and Enterprise is set per contract. Email [email protected].