Sign in

v1

latestOpenAPI 3.0.12026-08-0673352.8 KB
API-Version-2.0

Get fixtures (i.e. sporting events without markets or metadata) for a given sport on a given date

Shows live, upcoming and pre-trading fixtures of a given sport for a given date or time-range. Also note that a "day" counts as 00:00:00 UTC to 23:59:59 UTC on the requested date.

get/v2/odds/fixtures

Query parameters

sportstring required

sport to query fixtures for, e.g. tennis

datestring

date for which you want to query events in ISO 8601 (YYYY-MM-DD) format, e.g. 2021-05-27 The timerange on the date for which events are returned is from 00:00:00 UTC to 23:59:59 UTC If limit is not sent as a separate query string, it is set to 10000 to get all events for a day Either date or from + to query params are REQUIRED in your request to specify a valid time-range. date can't be sent together with from or to

frominteger

time range for events, Unix epoch time, i.e. seconds since January 1, 1970 midnight UTC; e.g. 1618997973 Either date or from + to query params are REQUIRED in your request to specify a valid time-range. date can't be sent together with from or to

tointeger

time range for events, Unix epoch time, i.e. seconds since January 1, 1970 midnight UTC; e.g. 1619042340 Either date or from + to query params are REQUIRED in your request to specify a valid time-range. date can't be sent together with from or to

playersboolean

if true, include players information

limitinteger

Limit the number of events

Response

FixturesResponse

Example response

{
  "competitions": [
    {
      "category": {
        "key": "\"Tennis\"",
        "name": "\"tennis\""
      },
      "events": [
        {
          "away": {
            "abbreviation": "\"NAD\"",
            "key": "\"c886a-nadal-rafael\"",
            "name": "\"Rafael Nadal\"",
            "nationality": "\"ESP\""
          },
          "cutoffTime": "\"2021-06-09T09:00:00Z\"",
          "home": {
            "abbreviation": "\"NAD\"",
            "key": "\"c886a-nadal-rafael\"",
            "name": "\"Rafael Nadal\"",
            "nationality": "\"ESP\""
          },
          "id": 7498746,
          "key": "\"c886a-nadal-rafael-v-c8973-schwartzman-diego\"",
          "name": "\"Rafael Nadal V Diego Schwartzman\""
        }
      ],
      "key": "\"tennis-atp-french-open-men-singles\"",
      "name": "\"French Open, Men Singles\""
    }
  ]
}