ODoddspapi
common

Get Bookmakers

Changed on

List bookmakers.

Returns the bookmaker catalog available to the provided apiKey.

Lookup mode: bookmakers (optional filter list) + playerProps (optional capability filter).

get/bookmakers

Request

  • Base URL
    https://v5.oddspapi.io/en
  • URL
    https://v5.oddspapi.io/en/bookmakers
  • Auth
    • API key in query parameter apiKey
    • or API key in header X-API-Key

Query parameters

bookmakersstring nullable

Comma- or space-separated bookmaker slugs. Supports * / all for wildcard.

playerPropsboolean nullable

If true, only return bookmakers that support player proposition markets.

Response

Returns Bookmaker[]

slugstring required

Stable bookmaker slug — the key used in bookmakers filters and in all odds payloads.

bookmakerNamestring required

Bookmaker display name.

activeboolean required

Whether the bookmaker is currently served by the API.

domainstring uri nullable

Main public website URL of the bookmaker.

serverGroupstring nullable

Deprecated internal field — safe to ignore for API consumers.

priceinteger nullable

Deprecated internal field — safe to ignore for API consumers.

websocketPregameboolean nullable

Whether pregame odds for this bookmaker are streamed over the WebSocket.

websocketLiveboolean nullable

Whether live (in-play) odds for this bookmaker are streamed over the WebSocket.

playerPropsboolean nullable

Whether this bookmaker offers player proposition markets.

maxDelayPregameInSecnumber nullable

Maximum expected refresh delay for pregame odds, in seconds — the freshness bound for this bookmaker. Measured from observed vs. bookmaker change times (currently the rolling p50) where the book publishes usable timestamps, estimated otherwise.

maxDelayLiveInSecnumber nullable

Maximum expected refresh delay for live odds, in seconds. Measured from observed vs. bookmaker change times (currently the rolling p50) where the book publishes usable timestamps, estimated otherwise.

maxDelayPregameMainInSecnumber nullable

Maximum expected refresh delay for pregame main lines, in seconds. Measured from observed vs. bookmaker change times (currently the rolling p50) where the book publishes usable timestamps, estimated otherwise.

availableCountriesstring[] nullable

ISO 3166-1 alpha-2 country codes where the bookmaker accepts customers.

Changes

  • 9ca3a6a3c1e8Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property items/price deprecated

    • info

      response property items/serverGroup deprecated