Team of the week periods
GET
/
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
idpathrequired
league id issued by DataSportsAPI, a positive integer
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
Response
- data
TeamOfTheWeekPeriod[]- meta
- season, count
- errors
- 403
history_not_in_plan— your plan’s history window begins after this season ended404not_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" }, … ] }