Discovery

Sports and competitions

Every competition on the matched boards, grouped, with the market keys seen under each. Free. Paged 250 rows at a time in (group, key) order; a cursor expires 300 s after it was issued. region missing means uk; discovery is not scoped to your key's regions.

get/v2/sports

Request

  • Base URL: https://api.oddsrelay.io
  • URL: https://api.oddsrelay.io/v2/sports
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

regionstring

ONE lowercase region code (/v2/regions lists yours). Missing means uk: on a data route only when your key covers uk, else 400 region_required naming a code your key has; on discovery and keyless routes always. A comma list, the parameter sent twice or an uppercase code is 400 bad_request; an unknown code, or one with no live bookmaker here, is 404 unknown_region.

format'envelope' | 'bare'

envelope (default): {meta, data}. bare: the data array alone, meta moved to X-* headers.

dateFormat'iso' | 'unix'

iso (default, ISO-8601 UTC) or unix (integer epoch seconds) for commence_time, processed_at and last_update. standard and dutching serve iso only: anything else is 400.

cursorstring

The previous page's meta.next_cursor (or X-Next-Cursor). A cursor is bound to no account and expires 300 s after it was issued: 400 cursor expired: start again from the first page; any other shape 400 cursor not recognised: start again from the first page.

Response

A page. Gzip unless refused (over 1 kB).

OR

Changes

No recorded changes to this operation across all 1 revision of this API.