Rounds
GET
/
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
idpathrequired
league id issued by DataSportsAPI, a positive integer
seasonqueryrequired
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 } }