Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Leagues

Team of the week periods

GET

/v2/leagues/{id}/team-of-the-week/periods

All plans

View as MarkdownTry in Playground →

Every period in the season for which a team of the week exists, newest first — rounds in football and other round-based leagues, weeks in the NBA.

An empty array means our data source picked no team of the week in that league and season. Any period id from this list works with /v2/leagues/{id}/team-of-the-week.

Parameters

id

pathrequired

league id issued by DataSportsAPI, a positive integer

season

queryrequired

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

Response

meta
season, count
errors
403 history_not_in_plan — your plan’s history window begins after this season ended404 not_found — the season id does not belong to this league

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}/team-of-the-week/periods?season=…"
Example
{ "data": [ { "id": 812604, "kind": "round", "sequence": 9, "round": 9, "roundName": "9", "from": null, "to": null,
      "publishedAt": "2026-11-03T08:32:39.000Z" },
    { "id": 812281, "kind": "round", "sequence": 8, "round": 8, … }, … ],
  "meta": { "season": 200386, "count": 9 } }

// NBA: weeks
{ "data": [ { "id": 812590, "kind": "week", "sequence": 2, "round": null, "roundName": null,
      "from": "2026-10-26T07:00:00.000Z", "to": "2026-11-02T07:00:00.000Z", "publishedAt": "2026-11-02T07:28:22.000Z" }, … ] }