Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Rounds

GET

/v2/leagues/{id}/rounds

All plans

View as MarkdownTry in Playground →

Lists every round of a season and indicates which one is current.

Round numbers are not unique across phases — a qualifying round 1 and a league-phase round 1 can coexist — so pass both slug and prefix of the round to /fixtures to hit the right one. Where our data source does not structure a competition in rounds (NBA / NHL regular seasons, individual tennis or MMA events), this list is empty even though fixtures may still have fixture.round set.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

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

Response

data
Rounds
meta
season
errors
404 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}/rounds?season=…"
Example
{ "data": { "current": { "number": 3, "name": null, "slug": null, "prefix": null },
    "rounds": [ { "number": 1, "name": "Qualification Round 1", "slug": "qualification-round-1", "prefix": null },
                { "number": 636, "name": "Playoff round", "slug": "playoff-round", "prefix": "Qualification" },
                { "number": 1, "name": null, "slug": null, "prefix": null }, … ] },
  "meta": { "season": 200390 } }