rate_limited

The key exceeded a per-second or per-minute request window.

One company record
Company record

Official register

Legal nameAcme Studio Ltd
Company number01234567
StatusActive

HTTP 429 · Rate limited

Why it happens

Limits are enforced per key in fixed one-second and one-minute windows. A batch call counts as one request.

How to fix it

Honour the Retry-After header, then retry with backoff. Spread sustained traffic instead of bursting, or ask about a higher limit.

Example response

{
  "type": "https://corpoapi.com/errors/rate_limited",
  "title": "Rate limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "Rate limit exceeded. Retry after 1 second.",
  "request_id": "8f3c2a1e-5b7d-4c9a-9e2f-1a2b3c4d5e6f"
}

The error envelope is the same on every endpoint. Read the full error contract.

All API error codes

Related

Start free with Corpo API

Verify any company from official registers with one API.