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

One request can carry many items, up to these caps:

Endpoint	Limit
POST /api/v1/tariff-rates	50 lines per request
POST /api/v1/export-control	50 products per request
POST /api/v1/origin	5 jobs per request, 200 BOM lines each
POST /api/v1/classifications	10 destinations per request
POST /api/v1/classifications/batch	10,000 inline items, or a JSONL file up to 100 MB
POST /api/v1/audit/runs	50 files per run