Series Schedule

get

https://api.sportradar.com/nba/{access_level}/v8/{language_code}/series/{season_year}/{season_type}/schedule.{format}

NBA Series Schedule Playoff participant information as well as the date, time, location, and other event details for every match-up taking place for the entire playoffs.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
TTL / Cache:

10 minutes for days with active games (games in non-closed status)

4 hours for days without active games

Data Updates:

Schedule info updates in realtime as changes are made.

The initial playoff schedule (with TBD matchups) will be available shortly after the regular season schedule is released.

Teams advance to the next round on a 2-minute timer after the previous game moves to complete status.

📘
Building a Playoff Bracket
Learn how to use the Series Schedule to build a playoff bracket and track playoff matchups as they advance in our Playoffs and Tournaments integration scenario.

Data Points

Game

Attribute	Parent Element	Type	Description
`alias`	`away`	String	Abbreviation of the away team ex. `MEM` (Memphis)
`id`	`away`	GUID	Unique ID of the away team ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c`
`away_team`	`game`	GUID	Unique ID of the away team ex. `583eca88-fb46-11e1-82cb-f4ce4684ea4c`
`name`	`away`	String	Team name of the away team ex. `Memphis Grizzlies`
`away_points`	`game`	Integer	Number of points for the away team
`reference`	`away`	String	League reference ID of the away team ex. `1610612750`
`seed`	`away`	Integer	Seed number for the away team
`sr_id`	`away`	GUID	Unique Sportradar ID of the away team ex. `sr:team:3415`
`channel`	`broadcast`	String	Name of a game's broadcast channel ex. `649`
`locale`	`broadcast`	String	Signifies the locale of a broadcast ex. `Home`, `Away`, `National`
`network`	`broadcast`	String	Name of a game's broadcast network ex. `ESPN`
`type`	`broadcast`	String	Type of broadcast ex. `TV`
`coverage`	`game`	String	Coverage level of a game `full`, `extended_boxscore`
`id`	`game`	GUID	Unique ID of a game ex. `1f730a9a-8221-48ff-a259-ac2103fb58b0`
`inseason_tournament`	`game`	Boolean	Signifies a game is part of the In-Season Tournament
`parent_id`	`game`	GUID	Standard parent ID of a game. Use this ID to group events (like the All-Star game) across seasons ex. `e4986bda-2f75-4228-8295-44b2449088b1`
`reference`	`game`	String	League reference ID of a game ex. `1610612758`
`sr_id`	`game`	GUID	Unique Sportradar ID of a game ex. `sr:match:35431817`
`status`	`game`	String	The status of a game `scheduled`, `created`, `inprogress`, `halftime`, `complete`, `closed`, `cancelled`, `delayed`, `postponed`, `time-tbd`, `if-necessary`, `unnecessary` Please see ourFAQ section for a list of game status definitions
`title`	`game`	String	Title of a game ex. `Game 3`
`alias`	`home`	String	Abbreviation of the home team ex. `GSW` (Golden State)
`id`	`home`	GUID	Unique ID of the home team ex. `583ec825-fb46-11e1-82cb-f4ce4684ea4c`
`home_team`	`game`	GUID	Unique ID of the home team ex. `583ec825-fb46-11e1-82cb-f4ce4684ea4c`
`name`	`home`	String	Team name of the home team ex. `Golden State Warriors`
`home_points`	`game`	Integer	Number of points for the home team
`reference`	`home`	String	League reference ID of the home team ex. `1610612750`
`seed`	`home`	Integer	Seed number for the home team
`sr_id`	`home`	GUID	Unique Sportradar ID of the home team ex. `sr:team:3428`
`neutral_site`	`game`	Boolean	Signifies a game played at a neutral venue
`scheduled`	`game`	dateTime	Scheduled date and time of a game ex. `2025-10-21T23:30:00+00:00`
`away`	`game` - `time_zones`	String	Time zone of the away team ex. `US/Pacific`
`home`	`game` - `time_zones`	String	Time zone of the home team ex. `US/Eastern`
`venue`	`game` - `time_zones`	String	Time zone of the venue ex. `US/Eastern`
`track_on_court`	`game`	Boolean	Signifies a game with tracking of players on the court. When true, we provide a `lineupchange` event type, `on_court` player for Play-by-Play events, and an `on_court` indicator in Game Summary

League

Attribute	Parent Element	Type	Description
`alias`	`league`	String	Alias of a league ex. `NBA`
`id`	`league`	GUID	Unique ID of a league ex. `4353138d-4c22-4396-95d8-5f587d2df25c`
`name`	`league`	String	Name of a league ex. `NBA`
`id`	`season-schedule`	GUID	Unique season ID ex. `583eca2f-fb46-11e1-82cb-f4ce4684ea4c`
`type`	`season-schedule`	String	Type of the season `PRE` (Preseason), `REG` (Regular Season), `IST` (In-Season Tournament), `PIT` (Play-In Tournament), `PST` (Postseason)
`year`	`season-schedule`	Integer	Year of the season

Series

Attribute	Parent Element	Type	Description
`name`	`series` - `participant`	String	Name of a series participant ex. `Celtics`
`record`	`series` - `participant`	Integer	Number of wins for a participant in a series
`seed`	`series` - `participant`	Integer	Seed number for a participant
`round`	`series`	String	Round number of a series
`id`	`series`	GUID	Unique ID of a series ex. `64e5e5c5-4912-4ff2-ac03-f1c80299da64`
`parent_id`	`series`	GUID	Standard parent ID of a series. Use this ID to group events (like the NBA Finals) across seasons ex. `a8187e6d-8b68-40bc-9767-fe78cbda3311`
`title`	`series`	String	Title of a series ex. `NBA Finals - BOS vs GSW` or `Eastern Conference - First Round - TOR vs PHI`
`id`	`series` - `participant` - `source`	GUID	Unique ID of the previous round for a participant ex. `3ba6b58a-c4b7-4067-9665-fa4c986aea3d`
`title`	`series` - `participant` - `source`	String	Title of the previous round for a participant ex. `Eastern Conference - Finals - BOS vs MIA`
`round`	`series` - `participant` - `source`	String	Number of the previous round for a participant
`outcome`	`series` - `participant` - `source`	String	Outcome of the previous round for a participant `win`
`start_date`	`series`	Date	Start date of a series ex. `2022-06-02`
`status`	`series`	String	Status of a series `scheduled`, `inprogress`, `closed`

Team

Attribute	Parent Element	Type	Description
`alias`	`series` - `participant` - `team`	String	Abbreviation of a team ex. `SAC` (Sacramento)
`id`	`series` - `participant` - `team`	GUID	Unique ID of a team ex. `583ed0ac-fb46-11e1-82cb-f4ce4684ea4c`
`market`	`series` - `participant` - `team`	String	Market name of a team ex. `Sacramento`
`name`	`series` - `participant` - `team`	String	Team name ex. `Kings`
`reference`	`series` - `participant` - `team`	String	League reference ID of a team ex. `1610612750`
`sr_id`	`series` - `participant` - `team`	GUID	Unique Sportradar ID of a team ex. `sr:team:3415`

Venue

Attribute	Parent Element	Type	Description
`address`	`venue`	String	Address of a venue ex. `500 David J. Stern Walkway`
`capacity`	`venue`	Integer	Capacity of a venue ex. `17608`
`city`	`venue`	String	City of a venue ex. `Sacramento`
`country`	`venue`	String	Country of a venue ex. `USA`
`id`	`venue`	GUID	Unique ID of a venue ex. `2e687b9a-c7a7-487c-85b4-43479abc8458`
`lat`	`venue` - `location`	Decimal	Latitude of a venue ex. `29.684735`
`lng`	`venue` - `location`	Decimal	Longitude of a venue ex. `-95.410725`
`name`	`venue`	String	Name of a venue ex. `Golden 1 Center`
`sr_id`	`venue`	GUID	Unique Sportradar ID of a venue ex. `sr:venue:6942`
`state`	`venue`	String	State or province of a venue ex. `CA`
`zip`	`venue`	String	ZIP code of a venue ex. `95814`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

br (Brazilian Portuguese), de (German), el (Greek), en (English), es (Spanish), fr (French), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), ru (Russian), tl (Tagalog), tr (Turkish), zh (simplified Chinese)

season_year

string

enum

required

Defaults to 2024

Year of a season in YYYY format

Note: Season year is always the year a season begins. For example, 2024 for the 2024-25 season.

season_type

string

enum

required

Defaults to PST

Type of season

REG (Regular Season), IST (In-Season Tournament), PIT (Play-In Tournament), PST (Postseason)

Allowed:

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Update Frequency

Building a Playoff Bracket

Data Points

200200