Skip to main content
Basics

Errors & pagination

Errors

Errors return a JSON envelope and a standard HTTP status:

{ "error": { "code": "invalid_key", "message": "API key is invalid or has been revoked." } }

Common statuses:

  • 401 missing_credentials / invalid_key — no key, or an invalid/revoked key.
  • 403 insufficient_scope — the key lacks the required scope.
  • 404 not_found — the resource doesn't exist, or your org isn't a party to it.
  • 429 rate_limited — over the 120/min limit; retry after Retry-After seconds.

Pagination

List endpoints accept a limit query parameter (1–100, default 50) and return:

{ "data": [ … ], "has_more": true, "limit": 50 }

Results are newest-first. has_more indicates there are additional records beyond the returned page.