NBA Season Contract Status

get

https://api.sportradar.com/basketball-nba/{access_level}/v2/{language_code}/seasons/{season_id}/players/contract_status.{format}

Global Basketball NBA Season Contract Status provides 2-way and 10-day contract status for NBA players in a given season.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
300s Time To Live / Cache

🏀
Access
This endpoint is part of the basketball-nba sub-package of the Global Basketball API. Access is for betting clients only and is granted through your account manager or sales representative.

Data Points

Competitor

Attribute	Parent Element	Type	Description
`id`	`competitor`	String	Unique ID for a competitor ex. `sr:competitor:3423` (Atlanta Hawks)
`name`	`competitor`	String	Name for a competitor ex. `Atlanta Hawks`

Player

Attribute	Parent Element	Type	Description
`contract_status`	`player`	String	Current contract type for a player `two_way`, `ten_day`
`first_name`	`player`	String	First name of a player ex. `Jalen`
`id`	`player`	String	Unique ID of a player ex. `sr:player:1793960`
`last_name`	`player`	String	Last name of a player ex. `Wilson`
`status_updated_at`	`player`	DateTime	Last update timestamp for the contract status ex. `2026-07-21T00:00:00+00:00`

Path Params

access_level

string

enum

required

Defaults to production

The access level of your API key

trial, production

Allowed:

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), nl (Dutch), no (Norwegian), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), sv (Swedish), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

season_id

string

required

Defaults to sr:season:142074

Unique Id of a season, found in the Seasons endpoint

Note: The API provides a maximum of 3 seasons per competition — 2 previous seasons and 1 current season.

Example: sr:season:119811

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Query Params

start

integer

≥ 0

Defaults to 0

The number of items to skip before starting to collect the result set.
Default: 0

Example: start=100 to receive a 2nd page of results (if necessary)

Note: You may alternatively use offset

limit

integer

1 to 200

Defaults to 200

The number of items to return.
Maximum: 200
Default value: 200

Example: limit=50

Note: Pagination may be required to pull all data within this feed. By default, the feed will return 200 items.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json