Rate limits - The Data City

Match endpoints

POST /api/v1/match and POST /api/v1/match/batch are limited to 30 requests per minute (per authenticated client, via the API key). When you exceed the limit, the API returns 429:

{
  "error": "Rate limit exceeded: 30 per 1 minute"
}

Every counted request counts toward the limit regardless of whether matching succeeded.

Status and results polling (GET /match/batch/{job_id} and …/results) are not subject to the same match limiter as submit. Still avoid busy-looping — poll every few seconds.

Backing off

Retry 429 with exponential backoff:

attempt 1 → wait 2 s
attempt 2 → wait 4 s
attempt 3 → wait 8 s
attempt 4 → give up, surface the error

Add random jitter (0–500 ms).

Batch size vs rate limit

A single batch submit is one HTTP request, even if it contains up to 1,000 companies. Prefer batching over many POST /match calls so you stay under the per-minute limit.

Last modified on August 20, 2026

⌘I

​Match endpoints

​Backing off

​Batch size vs rate limit

Match endpoints

Backing off

Batch size vs rate limit