name: OddsRelay Error Codes
generated: '2026-10-09'
method: searched
source: https://oddsrelay.io/docs
format: custom-json
envelope: '{"error": {"code", "message", "request_id"}}'
note: Branch on code, not message.
problems:
- status: 400
  title: bad_request
  type: bad_request
- status: 400
  title: missing_param
  type: missing_param
- status: 400
  title: region_required
  type: region_required
- status: 400
  title: unknown_bookmaker
  type: unknown_bookmaker
- status: 400
  title: unknown_exchange
  type: unknown_exchange
- status: 400
  title: unknown_market
  type: unknown_market
- status: 400
  title: unknown_sport
  type: unknown_sport
- status: 401
  title: expired_api_key
  type: expired_api_key
- status: 401
  title: invalid_api_key
  type: invalid_api_key
- status: 401
  title: missing_api_key
  type: missing_api_key
- status: 401
  title: paused_api_key
  type: paused_api_key
- status: 401
  title: revoked_api_key
  type: revoked_api_key
- status: 402
  title: insufficient_tokens
  type: insufficient_tokens
- status: 403
  title: account_suspended
  type: account_suspended
- status: 403
  title: bookmaker_not_in_plan
  type: bookmaker_not_in_plan
- status: 403
  title: bookmaker_not_in_region
  type: bookmaker_not_in_region
- status: 403
  title: exchange_not_in_plan
  type: exchange_not_in_plan
- status: 403
  title: market_not_in_plan
  type: market_not_in_plan
- status: 403
  title: not_in_key_scope
  type: not_in_key_scope
- status: 403
  title: origin_not_allowed
  type: origin_not_allowed
- status: 403
  title: product_not_in_region
  type: product_not_in_region
- status: 403
  title: region_not_in_scope
  type: region_not_in_scope
- status: 403
  title: schema_not_in_scope
  type: schema_not_in_scope
- status: 403
  title: sport_not_in_plan
  type: sport_not_in_plan
- status: 404
  title: not_found
  type: not_found
- status: 404
  title: unknown_event
  type: unknown_event
- status: 404
  title: unknown_region
  type: unknown_region
- status: 404
  title: unknown_type
  type: unknown_type
- status: 405
  title: method_not_allowed
  type: method_not_allowed
- status: 429
  title: too_many_from_address
  type: too_many_from_address
- status: 429
  title: too_many_requests
  type: too_many_requests
- status: 500
  title: internal_error
  type: internal_error
- status: 503
  title: raw_not_enabled
  type: raw_not_enabled
- status: 503
  title: temporarily_unavailable
  type: temporarily_unavailable