Errors

Errors use standard HTTP status codes and a consistent JSON body:

json

{
  "error": {
    "code": "invalid_scope",
    "message": "This key is not authorized for archive:read."
  }
}

HTTP status codes

Status	Meaning
`400`	Bad request — malformed parameters or body.
`401`	Unauthenticated — missing or invalid API key.
`403`	Forbidden — key lacks the required scope.
`404`	Not found — unknown game, event, or resource.
`422`	Unprocessable — valid shape, invalid values.
`429`	Rate limited — back off; see `Retry-After`.
`5xx`	Server error — retry with backoff; check status page.

Code	When
`invalid_key`	The API key is missing, malformed, or revoked.
`invalid_scope`	The key isn't authorized for this product or sport.
`invalid_body`	Request body failed validation.
`not_found`	The requested resource doesn't exist.
`rate_limited`	You've exceeded your plan's rate limit.
`plan_limit`	You've hit a plan cap (deliveries, connections). See Plan limits.

Questions? Talk to us. Pre-launch — endpoints illustrate the shape of the API.