Skip to content
datasportsAPI

LeaguesTeam of the week periods

Documentation

/

Type to filter the docs by title or path.

LeaguesEndpoint 81 of 116

Team of the week periods

GET

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

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
2 required · 0 optional
Returns
TeamOfTheWeekPeriod[]
Try 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.

Worth knowing

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.

01Parameters

  • idpathRequired

    league id issued by DataSportsAPI, a positive integer

  • seasonqueryRequired

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

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/leagues/{id}/team-of-the-week/periods?season=…"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
TeamOfTheWeekPeriod[]
meta
season, count
ObjectsTeamOfTheWeekPeriod
Example response
{ "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" }, … ] }

04Errors

  • 403history_not_in_plan

    your plan’s history window begins after this season ended

  • 404not_found

    the season id does not belong to this league

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code