Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

League fixtures

GET

/v2/leagues/{id}/fixtures

All plans

View as MarkdownTry in Playground →

Returns all fixtures in a single round of a season.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

round

queryrequired

round number taken from /rounds, between 1 and 9999

slug

query

slug of the round as given by /rounds, if the round has one

prefix

query

prefix of the round as given by /rounds; applied only in combination with slug

Response

data
Fixture[]
meta
season, round, slug, prefix, count
errors
400 bad_request — season or round is absent, or slug or prefix is malformed404 not_found — the season id does not belong to this league; the error message names the offending parameter, and /v2/leagues/{id}/seasons lists the valid ones

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/fixtures?season=…&round=…"
Example
{ "data": [ { "id": 201324, "round": { "number": 7, "name": null, "slug": null, "prefix": null }, … }, … ],
  "meta": { "season": 200386, "round": 7, "slug": null, "prefix": null, "count": 10 } }