NBA v3

API API Version Data Entry Workflow
National Basketball Association v3 Data Entry Workflow
Note: Authentication is required for all API calls.
## NBA API Map To best utilize the NBA API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need. >

Examples:

>To find a team's leader in assists for a given game: >
  1. Call the season or series schedule and find the Game Id for the chosen game
  2. Call the Game Boxscore using the Game Id
  3. Find the Team Assists Leader statistics and locate the player full_name attribute
>The name of the team's leader in assists is displayed. >
    >To find a player's average points per game: >
    1. Call the season or series schedule and find id for the team the player is on
    2. Call the Team Profile using the Team ID
    3. Locate the Player ID for your chosen player and call the Player Profile.
    4. Find the average element with the points attribute
    >The players's average points are displayed. The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables. ## Coverage Levels We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible. Extended Boxscore – We provide scores, time remaining, and team leaders (assists, points, and rebounds), in a timely manner, as the game progresses. We provide team- and player-level data for the game within 30 minutes of the official results being posted. Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time remaining as well as team- and player-level data in near real time. Full coverage is available for all regular and post season games.
    Note: Preseason coverage of NBA games may vary. Due to data-entry coverage (from venue) not being available, some games may be covered via our extended boxscore coverage.
    ## Daily Change Log Information on any changes made to teams, players, game statistics, and standings.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Game Id
    League Data Points: League Id
    Player Data Points: Full Name Player Id
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/league/2013/12/21/changes.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/league/2013/12/21/changes.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/league/2013/12/21/changes.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Change Log. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/changes.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Change Log, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/changelog-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Daily Schedule Date, time, location, and other event details for every match-up taking place in the league defined day.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Away Team Alias
    Away Team Id
    Away Team Name
    Away Team Points
    Away Team Rotation Number
    Broadcast Cable
    Broadcast Internet
    Broadcast Network
    Broadcast Radio
    Broadcast Satellite
    Home Team Alias
    Home Team Id
    Home Team Name
    Home Team Points
    Home Team Rotation Number
    Game Coverage
    Game Id
    Game Status
    Game Title
    Neutral Site
    Scheduled Date and Time
    League Data Points: League Alias League Id League Name
    Venue Data Points: Address
    Capacity
    City
    Country
    Description
    Name
    State
    Venue ID
    Zip
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/games/2013/12/21/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/games/2013/12/21/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/games/2013/12/21/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the Daily Schedule, replace the parameters in the following URL: https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/games/`{year}`/`{month}`/`{day}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Schedule, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Daily Transfers Information for all transfers added or edited during the league defined day.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: League Alias League Id League Name
    Player Data Points: First Name
    Full Name
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Transfers Description
    Transfers Effective Date
    Transfers End Date
    Transfers Id
    Transfers New Team Id
    Transfers New Team Market
    Transfers New Team Name
    Transfers Notes
    Transfers Old Team Id
    Transfers Old Team Market
    Transfers Old Team Name
    Transfers Start Date
    Transfers Update Date
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/league/2013/12/21/transfers.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/league/2013/12/21/transfers.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/league/2013/12/21/transfers.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Daily Transfers. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/transfers.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day in 2 digit format (DD). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Daily Transfers, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/transfers-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Free Agents Information for all NBA free agents.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: League Alias League Id League Name
    Player Data Points: Abbreviated name
    Birth Date
    Birth Place
    College
    Experience
    First Name
    Full Name
    Height (in)
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Status
    Weight (lbs)
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/league/free_agents.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/league/free_agents.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/league/free_agents.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves Free Agents. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/league/free_agents.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Free Agents, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/free-agents-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Boxscore Top-level team scores by quarter, along with full statistics for each team‘s leaders in points, rebounds, and assists.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Away Team Id
    Game Clock
    Game Coverage
    Game Id
    Game Quarter
    Game Status
    Game Title
    Home Team Id
    Neutral Site
    Scheduled Date And Time
    Boxscore Data Points: Attendance
    Lead Changes
    Scoreboard Away Team Game Score
    Scoreboard Away Team Id
    Scoreboard Away Team Market
    Scoreboard Away Team Name
    Scoreboard Away Team Quarter Score
    Scoreboard Home Team Game Score
    Scoreboard Home Team Id
    Scoreboard Home Team Market
    Scoreboard Home Team Name
    Scoreboard Home Team Quarter Score
    Scoreboard Quarter Number
    Scoreboard Quarter Sequence
    Team Assists Leader Player Full Name
    Team Assists Leader Player Id
    Team Points Leader Player Full Name
    Team Points Leader Player Id
    Team Rebounds Leader Player Full Name
    Team Rebounds Leader Player Id
    Times Tied
    Player Data Points: Full Name
    Jersey Number
    Player Id
    Position
    Primary Position
    Player Game Statistics Data Points: Assists
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Shots
    Defensive Rebounds
    Field Goal Attempts
    Field Goal Percentage
    Field Goals Made
    Flagrant Fouls
    Free Throw Attempts
    Free Throw Percentage
    Free Throws Made
    Minutes Played
    Offensive Rebounds
    Personal Fouls
    Plus/Minus
    Points
    Rebounds
    Steals
    Technical Fouls
    Three Point Attempts
    Three Point Percentage
    Three Points Made
    Turnovers
    Two Point Attempts
    Two Point Percentage
    Two Points Made
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/boxscore.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/boxscore.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/boxscore.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. For a sample of a game in progress, and in overtime, click here. This endpoint retrieves the Game Boxscore information for a specific game. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/boxscore.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `game_id` | ID for a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Boxscore, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/game-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Game Summary Top-level boxscore information, along with detailed game stats at the team and player levels.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Away Team Id
    Game Clock
    Game Coverage
    Game Id
    Game Quarter
    Game Status
    Game Title
    Home Team Id
    Neutral Site
    Scheduled Date And Time
    Boxscore Data Points: Attendance
    Game Officials Assignment
    Game Officials Experience
    Game Officials First Name
    Game Officials Full Name
    Game Officials Id
    Game Officials Last Name
    Game Officials Number
    Lead Changes
    Scoreboard Away Team Game Score
    Scoreboard Away Team Id
    Scoreboard Away Team Market
    Scoreboard Away Team Name
    Scoreboard Away Team Quarter Score
    Scoreboard Home Team Game Score
    Scoreboard Home Team Id
    Scoreboard Home Team Market
    Scoreboard Home Team Name
    Scoreboard Home Team Quarter Score
    Scoreboard Quarter Number
    Scoreboard Quarter Sequence
    Times Tied
    Player Data Points: First Name
    Full Name
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Lineups Active For Game
    Lineups Played
    Lineups Games Started
    Player Game Statistics Data Points: Assists
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Shots
    Defensive Rebounds
    Field Goal Attempts
    Field Goal Percentage
    Field Goals Made
    Flagrant Fouls
    Foul Outs
    Free Throw Attempts
    Free Throw Percentage
    Free Throws Made
    Games Played
    Games Started
    Minutes Played
    Offensive Rebounds
    Personal Fouls
    Plus/Minus
    Points
    Rebounds
    Steals
    Technical Fouls
    Three Point Attempts
    Three Point Percentage
    Three Points Made
    Turnovers
    Two Point Attempts
    Two Point Percentage
    Two Points Made
    Team Game Statistics Data Points: Assists
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Shots
    Coach Technical Fouls
    Defensive Rebounds
    Fast Break Points
    Field Goal Attempts
    Field Goal Percentage
    Field Goals Made
    Flagrant Fouls
    Foul Outs
    Free Throw Attempts
    Free Throw Percentage
    Free Throws Made
    Minutes Played
    Offensive Rebounds
    Personal Fouls
    Points
    Points In the Paint
    Points off Turnovers
    Rebounds
    Second Chance Points
    Steals
    Team Rebounds
    Team Technical Fouls
    Team Turnovers
    Three Point Attempts
    Three Point Percentage
    Three Points Made
    Total Player Technical Fouls
    Turnovers
    Two Point Attempts
    Two Point Percentage
    Two Points Made
    Venue Data Points: Address
    Capacity
    City
    Country
    Description
    Name
    State
    Venue Id
    Zip
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/summary.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/summary.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/summary.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. For a sample of a game in progress, and in overtime, click here. This endpoint retrieves the Game Summary information for a specific game. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/summary.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `game_id` | ID for a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Game Summary, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/game-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Injuries Information concerning all active player injuries for all teams within the league.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: League Alias League Id League Name
    Player Data Points: First Name
    Full Name
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Player Injuries Data Points: Injury Comment
    Injury Description
    Injury Id
    Injury Start Date
    Injury Status
    Update Date
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/league/injuries.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/league/injuries.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/league/injuries.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves player injuries. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/league/injuries.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Injuries, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/injuries-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## League Hierarchy League, conference, division, and team identification and association information.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: Conference Alias
    Conference Id
    Conference Name
    Division Alias
    Division Id
    Division Name
    League Alias
    League Id
    League Name
    Team Data Points: Alias
    Id
    Market Name
    Venue Data Points: Address
    Capacity
    City
    Country
    Description
    Name
    State
    Venue Id
    Zip
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/league/hierarchy.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/league/hierarchy.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/league/hierarchy.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the League Hierarchy. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/league/hierarchy.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for League Hierarchy, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/nba/hierarchy-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## League Leaders NBA leader information for various offensive and defensive categories including full player seasonal statistics for each player in each category.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: Season Id Season Type Season Year
    League Leaders Data Points: Assists
    Assists Per Game
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Category Name
    Category Type
    Defensive Rebounds
    Defensive Rebounds Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Player Rank
    Points
    Points Per Game
    Rebounds
    Rebounds Per Game
    Stat Category
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Tied Flag
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Player Data Points: First Name
    Full Name
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Player Season Statistics Data Points: Assists
    Assists Per Game
    Assists to Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Ejections
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Foul Outs
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Games Started
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points Per Game
    Rebounds
    Rebounds Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/seasontd/2013/REG/leaders.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/seasontd/2013/REG/leaders.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/seasontd/2013/REG/leaders.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the League Leaders. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nba_season}`/leaders.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `season_year` | Year in 4 digit format (YYYY). | | `nba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for League Leaders, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/statistics-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Play-By-Play Detailed, real-time information on every team possession and game event.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Away Team Id
    Game Clock
    Game Coverage
    Game Id
    Game Half
    Game Status
    Game Title
    Home Team Id
    Neutral Site
    Scheduled Date And Time
    Boxscore Data Points: Attendance
    Scoreboard Away Team Game Score
    Scoreboard Away Team Quarter Score
    Scoreboard Away Team Id
    Scoreboard Away Team Market
    Scoreboard Away Team Name
    Scoreboard Half Id
    Scoreboard Half Number
    Scoreboard Half Sequence
    Scoreboard Home Team Game Score
    Scoreboard Home Team Quarter Score
    Scoreboard Home Team Id
    Scoreboard Home Team Market
    Scoreboard Home Team Name
    Lead Changes
    Times Tied
    Play-By-Play Data Points: Basket Team is Attacking
    Event Attempt
    Event Clock
    Event Description
    Event Free Throw Type
    Event Id
    Event Location X Coordinate
    Event Location Y Coordinate
    Event Participants Player Full Name
    Event Participants Player Id
    Event Participants Player Jersey Number
    Event Participants Team Id
    Event Participants Team Market
    Event Participants Team Name
    Event Shot Type
    Event Shot Type Description
    Event Turnover Type
    Event Type
    Home Team Game Score
    Home Team Id
    Home Team Market
    Home Team Name
    Home Team Quarter Score
    On Court Participants Player Full Name
    On Court Participants Player Id
    On Court Participants Player Jersey Number
    On Court Participants Team Id
    On Court Participants Team Market
    On Court Participants Team Name
    Possession Team Id
    Possession Team Market
    Possession Team Name
    Quarter Id
    Quarter Number
    Quarter Sequence
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/pbp.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/pbp.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/games/013dd2a7-fec4-4cc5-b819-f3cf16a1f820/pbp.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. For a sample of a game in progress, and in overtime, click here. This endpoint retrieves the Play-By-Play for a game. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/games/`{game_id}`/pbp.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `game_id` | ID for a given game. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Play-By-Play, replace the parameters in the following URL. https:///api.sportradar.us/nba-`{access_level}{version}`/schema/pbp-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Player Profile Detailed player information including a current look at the player’s statistics for the current season.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: League Alias
    League Id
    League Name
    Season Id
    Season Type
    Season Year
    Player Data Points: Abbreviated Name
    Birth Date
    Birth Place
    College
    Draft Pick
    Draft Round
    Draft Team
    Draft Year
    Experience
    First Name
    Full Name
    Height (in)
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Status
    Update Date
    Weight (lbs)
    Player Seasonal Statistics Data Points: Assists
    Assists Per Game
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Fouled Out
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Games Started
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points Per Game
    Rebounds
    Rebounds Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Team Data Points: Alias
    Id
    Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/players/37fbc3a5-0d10-4e22-803b-baa2ea0cdb12/profile.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/players/37fbc3a5-0d10-4e22-803b-baa2ea0cdb12/profile.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/players/37fbc3a5-0d10-4e22-803b-baa2ea0cdb12/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves a Player Profile. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/players/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `player_id` | ID for a given player. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Player Profile, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/profile-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Rankings Conference and division rank for each team, including post season clinching status.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: Conference Alias
    Conference Id
    Conference Name
    Division Alias
    Division Id
    Division Name
    League Alias
    League Id
    League Name
    Season Id
    Season Type
    Season Year
    Standings Data Points: Conference Rank Division Rank Playoff Status
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/seasontd/2013/REG/rankings.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/seasontd/2013/REG/rankings.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/seasontd/2013/REG/rankings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Rankings. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nba_season}`/rankings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `season_year` | Year in 4 digit format (YYYY). | | `nba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Rankings, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/nba/rankings-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Schedule Date, time, location, and other event details for every match-up taking place in the full league season.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Away Team Alias
    Away Team Id
    Away Team Name
    Away Team Points
    Away Team Rotation Number
    Broadcast Cable
    Broadcast Internet
    Broadcast Network
    Broadcast Radio
    Broadcast Satellite
    Home Team Alias
    Home Team Id
    Home Team Name
    Home Team Points
    Home Team Rotation Number
    Game Coverage
    Game Id
    Game Status
    Game Title
    Neutral Site
    Scheduled Date and Time
    League Data Points: League Alias
    League Id
    League Name
    Season Id
    Season Type
    Season Year
    Venue Data Points: Address
    Capacity
    City
    Country
    Description
    Name
    State
    Venue Id
    Zip
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/games/2013/REG/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/games/2013/REG/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/games/2013/REG/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Schedule. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/games/`{season_year}`/`{nba_season}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `season_year` | Year in 4 digit format (YYYY). | | `nba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Schedule, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Seasonal Statistics (Season To Date) Detailed team and player statistics for the defined season.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: Season Id Season Type Season Year
    Player Data Points: First Name
    Full Name
    Jersey Number
    Last Name
    Player Id
    Position
    Opponent Seasonal Statistics Data Points: Assists
    Assists Per Game
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Fast Break Points
    Fast Break Points Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Fouled Out
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points In the Paint
    Points In The Paint Per Game
    Points off Turnovers
    Points off Turnovers Per Game
    Points Per Game
    Rebounds
    Rebounds Per Game
    Second Chance Points
    Second Chance Points Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Player Seasonal Statistics Data Points: Assists
    Assists Per Game
    Assists to Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Fouled Out
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Games Started
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points Per Game
    Rebounds
    Rebounds Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Team Seasonal Statistics Data Points: Assists
    Assists Per Game
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Fast Break Points
    Fast Break Points Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Free Throw Attempts
    Fouled Out
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points In the Paint
    Points In The Paint Per Game
    Points off Turnovers
    Points off Turnovers Per Game
    Points Per Game
    Rebounds
    Rebounds Per Game
    Second Chance Points
    Second Chance Points Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/seasontd/2013/REG/teams/583eca2f-fb46-11e1-82cb-f4ce4684ea4c/statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/seasontd/2013/REG/teams/583eca2f-fb46-11e1-82cb-f4ce4684ea4c/statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/seasontd/2013/REG/teams/583eca2f-fb46-11e1-82cb-f4ce4684ea4c/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Seasonal Statistics for a given team. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nba_season}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `season_year` | Year in 4 digit format (YYYY). | | `nba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). | | `team_id` | ID for a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Seasonal Statistics, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/statistics-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Series Schedule Play-off participant information as well as the date, time, location, and other event details for every match-up taking place for the entire play-offs.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Game Data Points: Away Team Alias
    Away Team Id
    Away Team Name
    Away Team Points
    Away Team Rotation Number
    Away Team Seed Number
    Broadcast Cable
    Broadcast Internet
    Broadcast Network
    Broadcast Radio
    Broadcast Satellite
    Home Team Alias
    Home Team Id
    Home Team Name
    Away Team Points
    Home Team Rotation Number
    Home Team Seed Number
    Game Coverage
    Game Id
    Game Status
    Game Title
    Neutral Site
    Scheduled Date and Time
    League Data Points: League Alias
    League Id
    League Name
    Season Id
    Season Type
    Season Year
    Series Data Points: Series Id
    Series Title
    Status
    Round
    Start Date
    Participant Name
    Participant Seed
    Participant Record
    Team Data Points: Alias
    Id
    Market Name
    Venue Data Points: Address
    Capacity
    City
    Country
    Description
    Name
    State
    Venue Id
    Zip
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/series/2013/REG/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/series/2013/REG/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/series/2013/REG/schedule.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Series Schedule. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/series/`{season_year}`/`{nba_season}`/schedule.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `season_year` | Year in 4 digit format (YYYY). | | `nba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Series Schedule, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Series Statistics Detailed team and player statistics for the defined series.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    Series Data Points: Series Id Series Title Series Status
    Player Data Points: First Name
    Full Name
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Opponent Seasonal Statistics Data Points: Assists
    Assists Per Game
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Fast Break Points
    Fast Break Points Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Fouled Out
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points In the Paint
    Points In The Paint Per Game
    Points off Turnovers
    Points off Turnovers Per Game
    Points Per Game
    Rebounds
    Rebounds Per Game
    Second Chance Points
    Second Chance Points Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Player Seasonal Statistics Data Points: Assists
    Assists Per Game
    Assists to Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Fouled Out
    Free Throw Attempts
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Games Started
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points Per Game
    Rebounds
    Rebounds Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Team Seasonal Statistics Data Points: Assists
    Assists Per Game
    Assists To Turnover Ratio
    Blocked Attempts
    Blocked Attempts Per Game
    Blocked Shots
    Blocked Shots Per Game
    Defensive Rebounds
    Defensive Rebounds Per Game
    Fast Break Points
    Fast Break Points Per Game
    Field Goal Attempts
    Field Goal Attempts Per Game
    Field Goal Percentage
    Field Goals Made
    Field Goals Made Per Game
    Flagrant Fouls
    Flagrant Fouls Per Game
    Free Throw Attempts
    Fouled Out
    Free Throw Attempts Per Game
    Free Throw Percentage
    Free Throws Made
    Free Throws Made Per Game
    Games Played
    Minutes Played
    Minutes Played Per Game
    Offensive Rebounds
    Offensive Rebounds Per Game
    Personal Fouls
    Personal Fouls Per Game
    Points
    Points In the Paint
    Points In The Paint Per Game
    Points off Turnovers
    Points off Turnovers Per Game
    Points Per Game
    Rebounds
    Rebounds Per Game
    Second Chance Points
    Second Chance Points Per Game
    Steals
    Steals Per Game
    Technical Fouls
    Three Point Attempts
    Three Point Attempts Per Game
    Three Point Percentage
    Three Points Made
    Three Points Made Per Game
    Turnovers
    Turnovers Per Game
    Two Point Attempts
    Two Point Attempts Per Game
    Two Point Percentage
    Two Points Made
    Two Points Made Per Game
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/series/dc528f4c-c8c8-4067-9981-bb64ba1a3e2f/teams/583eccfa-fb46-11e1-82cb-f4ce4684ea4c/statistics.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/series/dc528f4c-c8c8-4067-9981-bb64ba1a3e2f/teams/583eccfa-fb46-11e1-82cb-f4ce4684ea4c/statistics.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/series/dc528f4c-c8c8-4067-9981-bb64ba1a3e2f/teams/583eccfa-fb46-11e1-82cb-f4ce4684ea4c/statistics.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Series Statistics for a given team. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/series/`{series_id}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `series id` | ID of a given series. | | `team_id` | ID for a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Series Statistics, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/statistics-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Standings Detailed team records across various views including, overall, conference, and division information.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: Conference Alias
    Conference Id
    Conference Name
    Division Alias
    Division Id
    Division Name
    League Alias
    League Id
    League Name
    Season Id
    Season Type
    Season Year
    Standings Data Points: Conference Losses
    Conference Winning Percentage
    Conference Wins
    Division Losses
    Division Winning Percentage
    Division Wins
    Games Behind Conference
    Games Behind Division
    Games Behind League
    Games Decided by 10 pts or More Losses
    Games Decided by 10 pts or More Winning Percentage
    Games Decided by 10 pts or More Wins
    Games Decided by 3 pts or Less Losses
    Games Decided by 3 pts or Less Winning Percentage
    Games Decided by 3 pts or Less Wins
    Home Losses
    Home Winning Percentage
    Home Wins
    Last 10 Games Losses
    Last 10 Games Winning Percentage
    Last 10 Games Wins
    Last 10 Home Games Losses
    Last 10 Home Games Winning Percentage
    Last 10 Home Games Wins
    Last 10 Road Games Losses
    Last 10 Road Games Winning Percentage
    Last 10 Road Games Wins
    Overall Losses
    Overall Point Differential
    Overall Points Against
    Overall Points For
    Overall Winning Percentage
    Overall Wins
    Overtime Losses
    Overtime Winning Percentage
    Overtime Wins
    Road Losses
    Road Winning Percentage
    Road Wins
    Streak
    Versus Atlantic Division Losses
    Versus Atlantic Division Winning Percentage
    Versus Atlantic Division Wins
    Versus Central Division Losses
    Versus Central Division Winning Percentage
    Versus Central Division Wins
    Versus Northwest Division Losses
    Versus Northwest Division Winning Percentage
    Versus Northwest Division Wins
    Versus Pacific Division Losses
    Versus Pacific Division Winning Percentage
    Versus Pacific Division Wins
    Versus Southeast Division Losses
    Versus Southeast Division Winning Percentage
    Versus Southeast Division Wins
    Versus Southwest Division Losses
    Versus Southwest Division Winning Percentage
    Versus Southwest Division Wins
    Versus Teams Above 500 Losses
    Versus Teams Above 500 Winning Percentage
    Versus Teams Above 500 Wins
    Versus Teams Below 500 Losses
    Versus Teams Below 500 Winning Percentage
    Versus Teams Below 500 Wins
    Team Data Points: Id Market Name
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/seasontd/2013/REG/standings.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/seasontd/2013/REG/standings.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/seasontd/2013/REG/standings.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the current Standings. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/seasontd/`{season_year}`/`{nba_season}`/standings.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `season_year` | Year in 4 digit format (YYYY). | | `nba_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for Standings, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/nba/standings-v2.0.xsd?api_key=`{your_api_key}` Return to API map ## Team Profile (Rosters) Detailed team information including league affiliation information and player roster information.
    Update Frequency: As Necessary
    Content Type: XML or JSON
    League Data Points: Conference Alias
    Conference Id
    Conference Name
    Division Alias
    Division Id
    Division Name
    League Alias
    League Id
    League Name
    Player Data Points: Abbreviated Name
    Birth Date
    Birth Place
    College
    Draft Pick
    Draft Round
    Draft Team
    Draft Year
    Experience
    First Name
    Full Name
    Height (in)
    Jersey Number
    Last Name
    Player Id
    Position
    Primary Position
    Status
    Weight (lbs)
    Team Data Points: Alias
    Experience (Years)
    Coach First Name
    Coach Full Name
    Coach Id
    Coach Last Name
    Coach Position
    Id
    Market
    Name
    Year Founded
    Venue Data Points: Address
    Capacity
    City
    Country
    Description
    Name
    State
    Venue Id
    Zip
    ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba-t3/teams/583eca2f-fb46-11e1-82cb-f4ce4684ea4c/profile.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba-t3/teams/583eca2f-fb46-11e1-82cb-f4ce4684ea4c/profile.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/nba-t3/teams/583eca2f-fb46-11e1-82cb-f4ce4684ea4c/profile.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. This endpoint retrieves the Team Profile. https://api.sportradar.us/nba-`{access_level}{version}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `language_code` | Optional 2 letter code for supported languages: ru (Russian), zh (simplified Chinese). | | `team_id` | ID for a given team. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.XSD) for the Team Profile, replace the parameters in the following URL. https://api.sportradar.us/nba-`{access_level}{version}`/schema/team-v2.0.xsd?api_key=`{your_api_key}` Return to API map