Note: Authentication is required for all API calls.
## NCAA Men's Basketball API Map
To best utilize the NCAA Men's Basketball 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:
>
Call the schedule or daily schedule and find the Game Id for the chosen game
Call the Game Boxscore using the Game Id
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:
>
Call the season or series schedule and find id for the team the player is on
Call the Team Profile using the Team ID
Locate the Player ID for your chosen player and call the Player Profile.
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.
Note: Tournament Ids are only listed in the Tournament List feed. Use the Tournament List to get the Ids required to access the Tournament Schedule and Tournament Summary.
## 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.
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 any game in which we have a reliable broadcast available and one or more participants are members of the following conferences: ACC, Big 12, Big East, Big Ten, PAC 12, or SEC.
Extended Boxscore – We provide scores and time remaining, in a timely manner, as the game progresses. We provide team and player level data for the game within 120 minutes of the official results being posted. Extended Boxscore coverage is available for any game involving a Division I program, not covered via our full coverage offering.
Note: All early season tournament games as well as all conference tournament games, available via a reliable broadcast, will be done via our full coverage offering.
Note: Coverage levels may be adjusted up to the scheduled start time at the discretion of our data entry managers for such reasons as resource availability as well as possible broadcast and technical difficulties.
## March Madness Workflow and Samples
Sportradar's data entry experts will have the entire field input within 2 hours of the announcements on Selection Sunday.
Prior to the matchup announcements, the Tournament Schedule and Tournament Summary feeds will return 200 results with basic Regional bracket information included. To access these feeds, you must input the NCAA Men's Division I Basketball Tournament unique ID, found in the [Tournament List](https://developer.sportradar.com/docs/basketball/NCAA_Mens_Basketball_v7#tournament-list) feed. See below for sample data.
Pre-Selection SundayTournament Schedule - Tournament Summary
During the matchup announcements all available team and schedule data is added to each feed. See below for sample data.
Selection Sunday - Top 4 Seeds Announced (Region Rank Included)Tournament Schedule - Tournament SummarySelection Sunday - Midway Through AnnouncementTournament Schedule - Tournament Summary
The below sample provides the behavior of the Schedule and Summary feeds after all Selection Sunday matchups have been announced and populated in our feeds.
After Selection SundayTournament_Schedule - Tournament Summary
Lastly, you can reference a completed Division I Tournament bracket here and here.
## 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 Point:
Id
League Data Point:
Season 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/ncaamb/trial/v3/en/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", "/ncaamb/trial/v3/en/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/ncaamb/trial/v3/en/league/2013/12/21/changes.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Change Log feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/league/`{year}`/`{month}`/`{day}`/changes.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{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 Broadcast Cable Broadcast Internet
Broadcast Network Broadcast Radio Broadcast Satellite Conference Game Game Coverage Game Id Game Status
Game Title Home Team Alias Home Team Id Home Team Name Home Team Points 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/ncaamb/trial/v3/en/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", "/ncaamb/trial/v3/en/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/ncaamb/trial/v3/en/games/2013/12/21/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Daily Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/games/`{year}`/`{month}`/`{day}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Game Boxscore
Top-level team scores by half along with full statistics for each team‘s leaders in points, rebounds, and assists.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Boxscore Data Points:
Attendance Lead Changes Possession Arrow Scoreboard Away Team Bonus Flag Scoreboard Away Team Double Bonus Flag Scoreboard Away Team Game Score Scoreboard Away Team Half Score Scoreboard Away Team Id Scoreboard Away Team Market Scoreboard Away Team Name
Scoreboard Away Team Rank Scoreboard Half Number Scoreboard Half Sequence Scoreboard Home Team Bonus Flag Scoreboard Home Team Double Bonus Flag Scoreboard Home Team Game Score Scoreboard Home Team Half Score Scoreboard Home Team Id Scoreboard Home Team Market Scoreboard Home Team Name
Scoreboard Home Team Rank Scoreboard Overtime Number Scoreboard Overtime 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
Game Data Points:
Away Team Id Conference Game Game Clock Game Coverage
Game Half Game Id Game Status Game Title
Home Team Id Neutral Site Scheduled Date And Time
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
Player Data Points:
Full Name Id
Jersey Number Position
Primary Position
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/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", "/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/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/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/boxscore.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Game Boxscore feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/games/`{game_id}`/boxscore.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{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
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 Lineups Active For Game Lineups Ejected Lineups Foul Outs
Lineups Played Lineups Started Possession Arrow Scoreboard Away Team Bonus Flag Scoreboard Away Team Double Bonus Flag Scoreboard Away Team Game Score Scoreboard Away Team Half Score Scoreboard Away Team Id Scoreboard Away Team Market Scoreboard Away Team Name Scoreboard Away Team Rank Scoreboard Half Number
Scoreboard Half Sequence Scoreboard Home Team Bonus Flag Scoreboard Home Team Double Bonus Flag Scoreboard Home Team Game Score Scoreboard Home Team Half Score Scoreboard Home Team Id Scoreboard Home Team Market Scoreboard Home Team Name Scoreboard Home Team Rank Scoreboard Overtime Number Scoreboard Overtime Sequence Times Tied
Game Data Points:
Away Team Id Conference Game Game Clock Game Coverage
Game Half Game Id Game Status Game Title
Home Team Id Neutral Site Scheduled Date And Time
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 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 Ejections 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
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
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/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/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", "/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/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/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Game Summary feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/games/`{game_id}`/summary.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{access_level}{version}`/schema/game-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/ncaamb/trial/v3/en/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", "/ncaamb/trial/v3/en/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/ncaamb/trial/v3/en/league/hierarchy.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the League Hierarchy feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/league/hierarchy.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{access_level}{version}`/schema/ncaam/hierarchy-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## League Leaders
NCAA 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 Shots Blocked Shots Per Game Category Name Category Type Field Goal Percentage Free Throw Percentage Minutes Played
Minutes Played Per Game Offensive Rebounds Personal Fouls Personal Fouls Per Game Player Rank Points Points Per Game Rebounds Rebounds Per Game
Stat Category Steals Steals Per Game Three Point Percentage Tied Flag Turnovers Turnovers Per Game Two Point Percentage
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
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 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/ncaamb/trial/v3/en/seasons/2013/REG/18b713d6-561d-4aab-8986-175c4da04aa8/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", "/ncaamb/trial/v3/en/seasons/2013/REG/18b713d6-561d-4aab-8986-175c4da04aa8/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/ncaamb/trial/v3/en/seasons/2013/REG/18b713d6-561d-4aab-8986-175c4da04aa8/leaders.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the League Leaders feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{ncaamb_season}`/`{division/conference}`/leaders.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamb_season` | Preseason (PRE), Regular Season (REG), or Postseason (PST). |
| `division/conference` | ID for a given division or conference. |
| `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/ncaamb-`{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
Boxscore Data Points:
Attendance Lead Changes Possession Arrow Scoreboard Away Team Bonus Flag Scoreboard Away Team Double Bonus Flag Scoreboard Away Team Game Score
Scoreboard Away Team Half Score Scoreboard Away Team Id Scoreboard Away Team Market Scoreboard Away Team Name Scoreboard Home Team Bonus Flag Scoreboard Home Team Double Bonus Flag
Scoreboard Home Team Game Score Scoreboard Home Team Half Score Scoreboard Home Team Id Scoreboard Home Team Market Scoreboard Home Team Name Times Tied
Game Data Points:
Away Team Id Conference Game Game Clock Game Coverage
Game Half Game Id Game Status Game Title
Home Team Id Neutral Site Scheduled Date And Time
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 Half Id Half Number Half Sequence Possession Team Id Possession Team Market Possession Team Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/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", "/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/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/ncaamb/trial/v3/en/games/e186b214-8562-4c80-8b90-0a3a62a86ae3/pbp.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Play-By-Play feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/games/`{game_id}`/pbp.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `game_id` | ID of 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/ncaamb-`{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 players 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 Place Experience First Name
Full Name Height (in) Id Jersey Number
Last Name Position Primary Position Status Weight (lbs)
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:
Alias Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/players/6abf9144-80e0-4dc0-91a0-d1ad99f12476/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", "/ncaamb/trial/v3/en/players/6abf9144-80e0-4dc0-91a0-d1ad99f12476/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/ncaamb/trial/v3/en/players/6abf9144-80e0-4dc0-91a0-d1ad99f12476/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Player Profile feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/players/`{player_id}`/profile.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{access_level}{version}`/schema/profile-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Rankings (Current Week)
List of current Associated Press and USAToday rankings including those teams not ranked, but receiving votes.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Rankings Data Points:
Effective Time First Place Votes Poll Alias Poll Id
Poll Name Poll Points Poll Rank
Votes Week Year
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/polls/US/2013/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", "/ncaamb/trial/v3/en/polls/US/2013/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/ncaamb/trial/v3/en/polls/US/2013/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Rankings feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/polls/`{poll_name}`/`{season_year}`/rankings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `poll_name` | Abbreviated 2 letter name of the poll: Associated Press (AP), USA Today (US). |
| `season_year` | Year in 4 digit format (YYYY). |
| `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/ncaamb-`{access_level}{version}`/schema/rankings-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Rankings (By Week)
List of current Associated Press and USAToday rankings including those teams not ranked, but receiving votes.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Rankings Data Points:
Effective Time First Place Votes Poll Alias Poll Id
Poll Name Poll Points Poll Rank
Votes Week Year
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/polls/US/2013/04/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", "/ncaamb/trial/v3/en/polls/US/2013/04/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/ncaamb/trial/v3/en/polls/US/2013/04/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured for AP., or US.
Access the Rankings By Week feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/polls/`{poll_name}`/`{season_year}`/`{ncaamb_week}`/rankings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `poll_name` | Abbreviated 2 letter name of the poll: Associated Press (AP), USA Today (US). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamb_week` | Week number in 1-2 digit format after a W (W14). Alternatively, PRE can be used for Pre-season, PST for Post-season, or PSTF Post-season final (USA Today only). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for weekly Rankings, replace the parameters in the following URL.
https://api.sportradar.us/ncaamb-`{access_level}{version}`/schema/rankings-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## RPI Rankings (Daily)
RPI information including rating, strength of schedule, ranking, and records based on Sportradar’s RPI calculations.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
Season Id
Season Type
Season Year
Rankings Data Points:
Adjusted Winning Pct Current API Rank Home Losses Home Wins Neutral Site Losses Neutral Site Wins Opponent’s Losses Opponent’s Opponent’s Winning Pct Opponent’s Ranked 1-25 Losses Opponent’s Ranked 1-25 Wins
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/polls/rpi/2013/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", "/ncaamb/trial/v3/en/polls/rpi/2013/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/ncaamb/trial/v3/en/polls/rpi/2013/rankings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the RPI Rankings feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/polls/rpi/`{season_year}`/rankings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for daily RPI Rankings, replace the parameters in the following URL.
https://api.sportradar.us/ncaamb-`{access_level}{version}`/schema/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 Broadcast Cable Broadcast Internet
Broadcast Network Broadcast Radio Broadcast Satellite Conference Game Game Coverage Game Id Game Status
Game Title Home Team Alias Home Team Id Home Team Name Home Team Points 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/ncaamb/trial/v3/en/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", "/ncaamb/trial/v3/en/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/ncaamb/trial/v3/en/games/2013/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/games/`{season_year}`/`{ncaamb_season}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamb_season` | Conference Tournament (CT), 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/ncaamb-`{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 Id
Jersey Number Last Name
Position Primary Position
Opponent 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 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 Foul Outs
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 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 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 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 Foul Outs
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
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/seasons/2013/REG/teams/2ed86226-3fff-4083-90fa-6b02307e6f73/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", "/ncaamb/trial/v3/en/seasons/2013/REG/teams/2ed86226-3fff-4083-90fa-6b02307e6f73/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/ncaamb/trial/v3/en/seasons/2013/REG/teams/2ed86226-3fff-4083-90fa-6b02307e6f73/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Seasonal Statistics feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{ncaamb_season}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamb_season` | Conference Tournament (CT), 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/ncaamb-`{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
League Alias League Id League Name
Season Id Season Type Season Year
Standings Data Points:
Conference Losses Conference Winning Percentage Conference Wins Games Behind Conference 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
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/seasons/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", "/ncaamb/trial/v3/en/seasons/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/ncaamb/trial/v3/en/seasons/2013/REG/standings.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Standings feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/seasons/`{season_year}`/`{ncaamb_season}`/standings.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamb_season` | Conference Tournament (CT), 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/ncaamb-`{access_level}{version}`/schema/ncaamb/standings-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Team Profile (Rosters)
Detailed team information including league affiliation information as well as 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 Place Experience First Name
Full Name Height (in) Jersey Number Last Name
Player Id Position Primary Position Status Weight (lbs)
Team Data Points:
Alias Coach Experience Coach First Name Coach Full Name
Coach Id Coach Last Name Coach Positition 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/ncaamb/trial/v3/en/teams/2ed86226-3fff-4083-90fa-6b02307e6f73/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", "/ncaamb/trial/v3/en/teams/2ed86226-3fff-4083-90fa-6b02307e6f73/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/ncaamb/trial/v3/en/teams/2ed86226-3fff-4083-90fa-6b02307e6f73/profile.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Team Profile feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/teams/`{team_id}`/profile.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `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/ncaamb-`{access_level}{version}`/schema/team-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Tournament List
Summarized list of all tournaments scheduled for the given season including tournament name, location, start date, and end date.
Update Frequency:
As Necessary
Content Type:
XML or JSON
League Data Points:
League Alias League Id
League Name Season Id
Season Type Season Year
Tournament Data Points:
End Date Start Date
Status Tournament Id
Tournament Location Tournament Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/tournaments/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", "/ncaamb/trial/v3/en/tournaments/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/ncaamb/trial/v3/en/tournaments/2013/REG/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Tournament List feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/tournaments/`{season_year}`/`{ncaamb_season}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `season_year` | Year in 4 digit format (YYYY). |
| `ncaamb_season` | Conference Tournament (CT), Regular Season (REG), or Postseason (PST). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for Tournaments List, replace the parameters in the following URL.
https://api.sportradar.us/ncaamb-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Tournament Schedule
Date, time, location, and other event details for every match-up taking place in the all scheduled tournament.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Game Data Points:
Away Team Previous Tournament Game Away Team Away Team Previous Tournament Game Coverage Away Team Previous Tournament Game Home Team Away Team Previous Tournament Game Id Away Team Previous Tournament Game Outcome Away Team Previous Tournament Game Scheduled Date and Time Away Team Previous Tournament Game Status Away Team Previous Tournament Game Title Away Team Alias Away Team Id Away Team Name Away Team Points
Away Team Seed Number Broadcast Cable Broadcast Internet Broadcast Network Broadcast Radio Broadcast Satellite Conference Game Game Coverage Game Id Game Status Game Title Home Team Previous Tournament Game Away Team Home Team Previous Tournament Game Coverage
Home Team Previous Tournament Game Home Team Home Team Previous Tournament Game Id Home Team Previous Tournament Game Outcome Home Team Previous Tournament Game Scheduled Date and Time Home Team Previous Tournament Game Status Home Team Previous Tournament Game Title Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Seed Number Neutral Site Scheduled Date and Time
League Data Points:
League Alias
League Id
League Name
Tournament Data Points:
Bracket Id Bracket Location Bracket Name Round Id
Round Name Round Sequence Status
Tournament Id Tournament Location Tournament 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/ncaamb/trial/v3/en/tournaments/3315299e-563d-4fbb-979e-81e58d5172fc/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", "/ncaamb/trial/v3/en/tournaments/3315299e-563d-4fbb-979e-81e58d5172fc/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/ncaamb/trial/v3/en/tournaments/3315299e-563d-4fbb-979e-81e58d5172fc/schedule.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
> The following are examples of the xml feed during March Madness: Selection Sunday Feed Example, Round 2 Complete, Round 3 Complete, Sweet 16 Complete, Elite 8 Complete, and Tournament Complete.
Access the Tournament Schedule feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/tournaments/`{tournament_id}`/schedule.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `tournament_id` | ID for a given tournament. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Tournaments Schedule, replace the parameters in the following URL.
https://api.sportradar.us/ncaamb-`{access_level}{version}`/schema/schedule-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Tournament Statistics (Tournament To Date)
Detailed team and player statistics for the defined tournament.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Tournament Data Points:
Tournament Status Tournament Id
Tournament Location
Tournament Name
Player Data Points:
First Name Full Name Id
Jersey Number Last Name
Position Primary Position
Opponent 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 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 Foul Outs
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 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 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 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 Foul Outs
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
Team Data Points:
Id
Market
Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/tournaments/7f72bb59-2698-4b2d-b802-fe8cfa8401c7/teams/1c7ec608-3b36-4cee-adac-9265e3792597/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", "/ncaamb/trial/v3/en/tournaments/7f72bb59-2698-4b2d-b802-fe8cfa8401c7/teams/1c7ec608-3b36-4cee-adac-9265e3792597/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/ncaamb/trial/v3/en/tournaments/7f72bb59-2698-4b2d-b802-fe8cfa8401c7/teams/1c7ec608-3b36-4cee-adac-9265e3792597/statistics.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Tournament Statistics feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/tournaments/`{tournament_id}`/teams/`{team_id}`/statistics.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `tournament_id` | ID for a given tournament. |
| `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 Tournament Statistics, replace the parameters in the following URL.
https://api.sportradar.us/ncaamb-`{access_level}{version}`/schema/statistics-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Tournament Summary (Seeded Tournaments Only)
Tournament information including location, status, start date, end date, set up and participants.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Tournament Data Points:
Bracket Id Bracket Location Bracket Name
End Date Start Date Status
Tournament Id Tournament Location Tournament Name
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/ncaamb/trial/v3/en/tournaments/3315299e-563d-4fbb-979e-81e58d5172fc/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", "/ncaamb/trial/v3/en/tournaments/3315299e-563d-4fbb-979e-81e58d5172fc/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/ncaamb/trial/v3/en/tournaments/3315299e-563d-4fbb-979e-81e58d5172fc/summary.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Tournament Summary feed by replacing the parameters in the following URL:
https://api.sportradar.us/ncaamb/`{access_level}`/`{version}`/`{language_code}`/tournaments/`{tournament_id}`/summary.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `access_level` | Defines the access level of your API key as Production (production) or Trial (trial). |
| `version` | Version number of the API you are accessing (Current Version: v3). |
| `language_code` | 2 letter code for supported language: en (English). |
| `tournament_id` | ID for a given tournament. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.XSD) for the Tournaments Summary, replace the parameters in the following URL.
https://api.sportradar.us/ncaamb-`{access_level}{version}`/schema/tournament-v2.0.xsd?api_key=`{your_api_key}`
Return to API map
## Frequently Asked Questions
Q: What format are date fields presented in?
A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What format are the date/time fields presented in?
A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What game statuses can I expect to see in the feeds and what are their definitions?
A: Here is a list of the valid game statuses you can expect to see, and their definitions.
scheduled - The game is scheduled to occur.
created – The game has been created and we have begun logging information.
inprogress – The game is in progress.
halftime - The game is currently at halftime.
complete – The game is over, but stat validation is not complete.
closed – The game is over and the stats have been validated.
cancelled – The game has been cancelled. No makeup game will be played as a result.
delayed – The start of the game is currently delayed or the game has gone from in progress to delayed for some reason.
postponed – The game has been postponed, to be made up at another day and time. Once the makeup game is announced, a new game and ID will be created and scheduled on the announced makeup date. You should request the scheduled feed(s) regularly to identify the re-scheduled makeup game(s).
time-tbd – The game has been scheduled, but a time has yet to be announced.
if-necessary – The game will be scheduled if it is required.
unnecessary – The series game was scheduled to occur, but will not take place due to one team clinching the series early.
Q: What are the player experience values I can expect to see in the feeds?
A: Here is a list of the valid player experience values and their definitions:
FR – Freshman
SO – Sophomore
JR – Junior
SR – Senior
GR – Graduate Student
Q: What player positions can I expect to see in the feeds?
A: Here is a list of the valid player positions you can expect to see.
NA
C
C-F
F
F-C
F-G
G
G-F
Q: What player primary positions can I expect to see in the feeds?
A: Here is a list of the valid player primary positions you can expect to see.
NA
C
PF
PG
SF
SG
Q: Are game statistics available for all teams during the regular season?
A: Game statistics are available for all Division I teams, regardless of the coverage level on the game. However, game statistics will only be available for non-Division I teams if the game is covered via our full coverage offering.
Q: Are seasonal statistics available for all teams during the regular season?
A: Seasonal statistics are available for all Division I teams.
Q: What player statuses can I expect to see in the feeds?
A: Here is a list of the valid player statuses you can expect to see.
ACT – The player is on the team’s active roster
NWT – The player is no longer with the team
SUS – The player is suspended
Q: What are the valid season types?
A: Here is a list of the valid season types and their definition:
reg – Regular season
ct – Conference tournaments
pst – Post-season
Q: What post-season national tournaments do you cover?
A: We will be covering the NCAA National Tournament (March Madness), the CBI, and the NIT. Here are the planned coverage levels for these tournaments:
March Madness – All games will be covered live via full coverage.
CBI – All games covered live, via Extended Boxscore coverage.
NIT – All games covered live, via Extended Boxscore coverage.
CIT – All games covered live, via Extended Boxscore coverage.
Q: How are you covering the new experimental rules for the 2016-17 NIT (National Invitational Tournament)?
A: When a team reaches the double bonus during a half, a "double bonus" attribute appears in the Play-By-Play, Game Summary, and Game Boxscore feeds with a value of "true." When the fouls reset at halftime or at the 10:00 mark of the half, the double bonus attribute is removed from these feeds. If a team reaches the double bonus again, the double bonus attribute will reappear with a value of true.
During the 2016-17 NIT, the “bonus” attribute will not be used.
Q: How do you plan to cover the conference tournaments games?
A: All conference tournament games, available via a reliable broadcast, will be done via our full coverage offering.
Q: What is the scale of the X Y coordinates?
A: The court we use is 1128 by 600. The scale is in inches. Here is a layout of the court:
0
X
1128
Y
600
Q: Why does the team_basket attribution in the play-by-play feed not match the basket orientation (left vs. right) in the broadcast or game tracking that I'm viewing?
A: Our team_basket attribution is set to match the orientation of the local television broadcast, which is on the opposite side of the scorer's table. The team_basket attribution may not match the orientation used by the particular broadcast or game tracker that you are viewing.
If you want to provide a perspective from the scorer's table, you will have to map the coordinates so that the coordinates attributed to left side of the court are attributed to the right side of the court on your end (and vice versa).
Q: What are the valid events types tracked in the play by play feed?
A: Here is a list of the valid event types you can expect to see.
clearpathfoul - <charged_to> clear path foul (<drawn_by> draws the foul)
threepointmade - <taken_by> makes three point <shot_type_desc> <shot_type> (<assisted_by> assists)
threepointmiss - <taken_by> misses three point <shot_type_desc> <shot_type>> or <blocked_by> blocks <taken_by> three point <shot_type_desc> <shot_type>
twopointmade - <taken_by> makes two point <shot_type_desc> <shot_type> (<assisted_by> assists)
twopointmiss - <taken_by> misses two point <shot_type_desc> <shot_type> or <blocked_by> blocks <taken_by> two point <shot_type_desc> <shot_type>
warning
Q: When will the NCAA Tournament schedule be available?
A: The initial release of the NCAA Tournament schedule will be released within 2 hours of the completion of the Selection Sunday telecast. More information can be found here.
Q: When are scores added to the schedule feeds?
A: Final scores are added to the schedule feeds when the game status changes to completed.
Q: How are home/away team designations determined for neutral-site games, and are those designations consistent across Sportradar products?
A: In the NCAAMB API, there are no "official" home/away designations for neutral-site games. For neutral-site games, we set the neutral-site value to "true".
As a result, this game will count towards Washington's and Colorado's neutral-site record and not their respective home and away records.
In the NCAAMB API, we use the home/away team designations present when we initially ingest the schedules. We will not change the home/away designations after the schedule is initially published. This does not apply to games that have been changed from a neutral-site game to a traditional home/away game, we may change home/away team designations in these cases.
Since other Sportradar products may publish schedules at different times and use different fixture management workflows, they may (for neutral-site games) display different home/away team designations.
Q: What shot type descriptions can I expect to see in the feeds?
A: Here is a list of the valid shot types with the descriptions you can expect to see for each shot type.
Jump Shot (This is the only shot type for 3-point attempts)