Get started

Rate limits

Requests are limited per minute and per day. Over the limit, a request returns 429 and tells you when to retry.

Request limits

Surface	Per minute	Per day
REST API (per API key)	Set by your plan	Set by your plan
MCP connector (per organization)	60	5,000

Headers

Every REST response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset for the per-minute window. A 429 adds Retry-After in seconds.

429 Too Many Requests

json

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit of 50 requests per minute exceeded",
    "retryAfter": 12,
    "resetsAt": "2026-10-23T14:23:45.000Z"
  }
}

Batch sizes

On v2, a list's cap is part of its schema: the API reference shows it as max items. The deprecated v1 endpoints cap a request at:

Endpoint	Limit
POST /api/v1/tariff-rates	50 lines per request
POST /api/v1/classifications	10 destinations per request