Skip to content
O ONCORR

Colour theme

Text size

Contrast

Request a quote

Rate limits & errors

Quotas, headers and error codes.

Rate limits

  • Each token has its own limit per minute: 120 by default, set between 10 and 1,000 when the token is created. Sandbox keys: 60 a minute.
  • Every answer carries X-RateLimit-Limit and X-RateLimit-Remaining.
  • Over the limit you get 429 rate_limited with a Retry-After header (seconds). Wait, then retry — do not hammer.
  • MCP calls count against the same token limit. Incoming signed actions: 240 a minute per address.

Errors

{"error": {"code": "insufficient_scope", "message": "This token does not have the \"registrations:write\" scope."}}
Error codes
StatusCodeMeaning
401unauthenticatedMissing, unknown, revoked or expired token.
401account_inactiveThe account that owns the token was switched off.
403insufficient_scopeThe token lacks the scope this endpoint needs.
403ip_not_allowedThe request came from an address outside the token’s allow-list.
404not_foundNot found — or not visible to this token (other clients’ events, non-demo events for sandbox keys).
409duplicateThe person is already registered (the answer includes registration_id).
422—Validation failed: message + errors per field.
429rate_limitedToo many requests. See Retry-After.

Pagination

Lists take page and per_page (1–100, default 25) and answer {"data": [...], "meta": {"page", "per_page", "total", "last_page"}, "links": {"next", "prev"}}. Follow links.next until it is null.

Dates and money

Dates are ISO 8601 (2026-11-02, 2026-11-02T08:41:00+00:00). Amounts are decimal numbers with a separate three-letter currency.