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?

HeaderMeaning
RateLimit-LimitRequests allowed in the window.
RateLimit-RemainingRequests left in the current window.
RateLimit-ResetSeconds until the window resets.
RateLimit-PolicyThe policy, e.g. 120;w=60.
Retry-AfterOn 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?

Can I get a higher limit?

The Scale plan allows 600 requests per minute and Enterprise is set per contract. Email [email protected].