Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs
Coverage MatrixDocumentationChange LogLog InContact Us

NCAAMB FAQs

Frequently asked questions for NCAA Men's Basketball v8

Click on the categories below or browse questions on the right panel.

Categories

.

Coverage


How is each NCAA Men's Basketball game covered?

Coverage levels for the NCAA Men's Basketball API can be found here.


Do full and extended boxscore games contain the same set of statistics?

No. We do not support the following statistics for extended boxscore games:

  • Biggest Lead
  • Coach Technical Fouls
  • Fouls Drawn
  • Most Unanswered Points
  • Most Unanswered Points Own Score
  • Most Unanswered Points Opponent Score
  • Offensive Fouls
  • Points in the Paint Attempts
  • Points in the Paint Made
  • Points in the Paint Percentage
  • Team Technical Fouls

Are game stats available for all teams during the regular season?

Game stats are available for all Division I teams, regardless of the game coverage level. However, game stats will only be available for non-Division I teams for full coverage games.


What post-season national tournaments do you cover?

We cover the NCAA National Tournament (March Madness), the CBI, CIT, and NIT. Here are the coverage levels for these tournaments:

  • March Madness – All games covered live with full coverage.
  • NIT – All games covered live with full coverage.
  • CBI – All games covered live with extended_boxscore coverage.
  • CIT – All games covered live with extended_boxscore coverage.

How do you cover conference tournament games?

All conference tournament games, available by a reliable broadcast, include full coverage.


How do you cover the NIT bonus rules?

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 endpoints 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 endpoints. 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.


NCAA Tournament


How does Sportradar cover the annual NCAA Tournament?

Check back soon for an updated workflow for the 2025 tournament.


Integration


Are simulations available for this API?

Yes! You can replay past games as though they were live using our on-demand Simulations service.


What format are date fields presented in?

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


What format are the date/time fields presented in?

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


How do I locate the TTL (Time to Live)/cache on an API endpoint?

The cache (in seconds) can be accessed in the returned header information on each RESTful API call, under cache-control.

ex. cache-control: max-age=1, public, s-maxage=1 or
cache-control: public, must-revalidate, max-age=120

The TTL may adjust when an event is live for some game-centric endpoints. This information is available for each endpoint on our developer portal.


Data Workflow

How can I find timings for data entry updates?

Our NCAAMB Data Entry Workflow section covers data availability updates. This includes updates for poll rankings, coverage levels, stat validation, and more.


Game Statuses


What game statuses can I expect to see and what are 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.
  • 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.

How do you handle forfeit games?

We mark a forfeit game with a status of closed. The final score is input as 2-0 in favor of the team not forfeiting.

<game xmlns="http://feed.elasticstats.com/schema/basketball/game-v7.0.xsd" id="3b154d1b-7bcf-4ff9-ab87-b35257cb30b2" status="closed" coverage="extended_boxscore" scheduled="2024-01-18T00:30:00+00:00" conference_game="true" clock="00:00" quarter="4" track_on_court="false" entry_mode="LDE" home_team="5f51a5c8-3004-43f2-a007-431de4f4bdb2" away_team="eae54b66-a3dc-4c1f-a81e-308b96ad1e41">
   <time_zones venue="US/Central" home="US/Central" away="US/Central" />
   <team name="Horned Frogs" alias="TCU" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" rank="0" home="true">
      <scoring>
         <quarter number="1" sequence="1" points="0" />
         <quarter number="2" sequence="2" points="0" />
         <quarter number="3" sequence="3" points="0" />
         <quarter number="4" sequence="4" points="0" />
      </scoring>
      <leaders />
   </team>
   <team name="Wildcats" alias="KSU" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="2" rank="7">
      <scoring>
         <quarter number="1" sequence="1" points="2" />
         <quarter number="2" sequence="2" points="0" />
         <quarter number="3" sequence="3" points="0" />
         <quarter number="4" sequence="4" points="0" />
      </scoring>
      <leaders />
   </team>
</game>

<game xmlns="http://feed.elasticstats.com/schema/basketball/pbp-v7.0.xsd" id="3b154d1b-7bcf-4ff9-ab87-b35257cb30b2" status="closed" coverage="extended_boxscore" scheduled="2024-01-18T00:30:00+00:00" conference_game="true" clock="00:00" quarter="4" track_on_court="false" entry_mode="LDE" home_team="5f51a5c8-3004-43f2-a007-431de4f4bdb2" away_team="eae54b66-a3dc-4c1f-a81e-308b96ad1e41">
   <time_zones venue="US/Central" home="US/Central" away="US/Central" />
   <scoring>
      <home name="Horned Frogs" alias="TCU" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" rank="0" />
      <away name="Wildcats" alias="KSU" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="2" rank="7" />
   </scoring>
   <quarter id="32d69a16-a0bc-4e30-90c9-3748118b6da9" number="1" sequence="1">
      <scoring>
         <home name="Horned Frogs" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" />
         <away name="Wildcats" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="2" />
      </scoring>
      <events />
   </quarter>
   <quarter id="72b5dc43-3819-4e98-9a89-56727bd06f66" number="2" sequence="2">
      <scoring>
         <home name="Horned Frogs" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" />
         <away name="Wildcats" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="0" />
      </scoring>
      <events />
   </quarter>
   <quarter id="dc7ba07a-02eb-4495-862e-66b7b2ad0b47" number="3" sequence="3">
      <scoring>
         <home name="Horned Frogs" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" />
         <away name="Wildcats" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="0" />
      </scoring>
      <events />
   </quarter>
   <quarter id="597c4da0-8920-4d28-a299-d261bab69161" number="4" sequence="4">
      <scoring>
         <home name="Horned Frogs" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" />
         <away name="Wildcats" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="0" />
      </scoring>
      <events />
   </quarter>
</game>

<game xmlns="http://feed.elasticstats.com/schema/basketball/game-v7.0.xsd" id="3b154d1b-7bcf-4ff9-ab87-b35257cb30b2" status="closed" coverage="extended_boxscore" scheduled="2024-01-18T00:30:00+00:00" conference_game="true" clock="00:00" quarter="4" track_on_court="false" entry_mode="LDE" home_team="5f51a5c8-3004-43f2-a007-431de4f4bdb2" away_team="eae54b66-a3dc-4c1f-a81e-308b96ad1e41">
   <time_zones venue="US/Central" home="US/Central" away="US/Central" />
   <venue id="1819e403-3649-4114-af21-f21d70cceb61" name="Schollmaier Arena" capacity="6800" address="3000 Stadium Drive" city="Fort Worth" state="TX" zip="76129" country="USA" />
   <team name="Horned Frogs" alias="TCU" market="TCU" id="5f51a5c8-3004-43f2-a007-431de4f4bdb2" points="0" rank="0" home="true">
      <scoring>
         <quarter number="1" sequence="1" points="0" />
         <quarter number="2" sequence="2" points="0" />
         <quarter number="3" sequence="3" points="0" />
         <quarter number="4" sequence="4" points="0" />
      </scoring>
      <coaches>
         <coach id="b3421b68-ee01-42ac-8647-1ab52799ed54" full_name="Mark Campbell" first_name="Mark" last_name="Campbell" position="Head Coach" />
      </coaches>
      <players>
         <player full_name="Sydney Harris" jersey_number="25" id="b169c6c2-8abb-48c9-8c8a-4ad3dc5aa3dc" first_name="Sydney" last_name="Harris" position="G-F" primary_position="NA" active="true" />
         <player full_name="Sedona Prince" jersey_number="13" id="e87f83be-5a28-435d-84f2-551ebcafa757" first_name="Sedona" last_name="Prince" position="F" primary_position="NA" active="true" />
         <player full_name="Madison Conner" jersey_number="3" id="a8995187-c3a6-4883-9b36-be36c9c9a7db" first_name="Madison" last_name="Conner" position="G" primary_position="NA" active="true" />
         <player full_name="Aaliyah Roberson" jersey_number="23" id="e5da7493-c75d-455b-84ba-5df7ba66beca" first_name="Aaliyah" last_name="Roberson" position="F" primary_position="NA" active="true" />
         <player full_name="Daija Turner" jersey_number="24" id="bb0eecbc-cff1-4e16-875c-511e2120f8b5" first_name="Daija" last_name="Turner" position="F" primary_position="NA" active="true" />
         <player full_name="Agnes Emma-Nnopu" jersey_number="21" id="a817793e-9808-41da-b0da-cac588741c9c" first_name="Agnes" last_name="Emma-Nnopu" position="G" primary_position="NA" active="true" />
         <player full_name="Knisha Godfrey" jersey_number="11" id="fabe4256-fb3a-4057-ad66-319771ea74d2" first_name="Knisha" last_name="Godfrey" position="G" primary_position="NA" active="true" />
         <player full_name="Jaden Owens" jersey_number="1" id="988f989e-16ac-45df-bc7d-1c6d43f27ae8" first_name="Jaden" last_name="Owens" position="G" primary_position="NA" active="true" />
         <player full_name="Bre'Yon White" jersey_number="12" id="0b28e96c-345e-4738-a4e0-161d90fd2af2" first_name="Bre'Yon" last_name="White" position="F" primary_position="NA" active="true" />
         <player full_name="Tara Manumaleuga" jersey_number="2" id="89c8b60d-5b8c-4df7-93e0-18bd087b443d" first_name="Tara" last_name="Manumaleuga" position="G" primary_position="NA" active="true" />
         <player full_name="Una Jovanovic" jersey_number="5" id="4d97f9ec-8a00-492b-b5a2-03750061e1cf" first_name="Una" last_name="Jovanovic" position="G" primary_position="NA" active="true" />
         <player full_name="Paige Bradley" jersey_number="15" id="f3e47a5c-aab2-41e6-9e0f-828505ba971a" first_name="Paige" last_name="Bradley" position="G" primary_position="NA" active="true" />
         <player full_name="Jade Clack" jersey_number="14" id="19fc3d4f-d4b9-4f19-8905-19755613ec90" first_name="Jade" last_name="Clack" position="F" primary_position="NA" active="true" />
         <player full_name="Victoria Flores" jersey_number="55" id="a6eb893c-b3f3-4cd1-876a-08d9e90e45b9" first_name="Victoria" last_name="Flores" position="G" primary_position="NA" active="true" />
      </players>
   </team>
   <team name="Wildcats" alias="KSU" market="Kansas State" id="eae54b66-a3dc-4c1f-a81e-308b96ad1e41" points="2" rank="7">
      <scoring>
         <quarter number="1" sequence="1" points="2" />
         <quarter number="2" sequence="2" points="0" />
         <quarter number="3" sequence="3" points="0" />
         <quarter number="4" sequence="4" points="0" />
      </scoring>
      <coaches>
         <coach id="099b02c7-48f2-4df9-b871-1ae6782f2d7a" full_name="Jeff Mittie" first_name="Jeff" last_name="Mittie" position="Head Coach" />
      </coaches>
      <players>
         <player full_name="Imani Lester" jersey_number="32" id="977c11fa-5367-445e-bc37-cd2ad80fc23f" first_name="Imani" last_name="Lester" position="F" primary_position="NA" active="true" />
         <player full_name="Serena Sundell" jersey_number="4" id="d652cd53-8c9c-4645-a668-50924ada13a5" first_name="Serena" last_name="Sundell" position="G" primary_position="NA" active="true" />
         <player full_name="Jaelyn Glenn" jersey_number="3" id="9e0a1967-627a-4c34-8610-3a5f00aff50b" first_name="Jaelyn" last_name="Glenn" position="G" primary_position="NA" active="true" />
         <player full_name="Alexis Hess" jersey_number="35" id="dadc480f-db63-4569-b3f0-c743034753e5" first_name="Alexis" last_name="Hess" position="F" primary_position="NA" active="true" />
         <player full_name="Mikayla Parks" jersey_number="10" id="3cea16b1-0730-4357-99c8-b7b01629606f" first_name="Mikayla" last_name="Parks" position="G" primary_position="NA" active="true" />
         <player full_name="Heavenly Greer" jersey_number="15" id="91b3bae1-3938-4d2d-a236-d9aebe664303" first_name="Heavenly" last_name="Greer" position="F" primary_position="NA" active="true" />
         <player full_name="Taryn Sides" jersey_number="11" id="813c391d-c2e2-43aa-9af7-4cbcad355c37" first_name="Taryn" last_name="Sides" position="G" primary_position="NA" active="true" />
         <player full_name="Eliza Maupin" jersey_number="21" id="8bcafe42-288a-4ee9-b60c-ba870cacd9dc" first_name="Eliza" last_name="Maupin" position="F" primary_position="NA" active="true" />
         <player full_name="Brylee Glenn" jersey_number="5" id="d9321e09-77c7-4f04-a35c-fa0e83418f33" first_name="Brylee" last_name="Glenn" position="G" primary_position="NA" active="true" />
         <player full_name="Ja'Mia Harris" jersey_number="2" id="6f2ed7bc-4084-43e2-9db3-2bcbf8299822" first_name="Ja'Mia" last_name="Harris" position="G" primary_position="NA" active="true" />
         <player full_name="Gabby Gregory" jersey_number="12" id="5680b0a4-d546-436b-9828-fc0933ee113c" first_name="Gabby" last_name="Gregory" position="G" primary_position="NA" active="true" />
         <player full_name="Zyanna Walker" jersey_number="1" id="c8e8665d-444c-4a06-9f58-691a9aa610fb" first_name="Zyanna" last_name="Walker" position="G" primary_position="NA" active="true" />
         <player full_name="Ayoka Lee" jersey_number="50" id="f890daee-b186-4494-8120-ec71cc501394" first_name="Ayoka" last_name="Lee" position="C" primary_position="NA" active="true" />
         <player full_name="Rebekah Dallinger" jersey_number="14" id="aa1ad377-3419-4e80-9a3e-1d4ee7e85009" first_name="Rebekah" last_name="Dallinger" position="G" primary_position="NA" active="true" />
         <player full_name="Gisela Sanchez" jersey_number="30" id="9c3ee58f-4ba8-438e-a230-b022d41e3799" first_name="Gisela" last_name="Sanchez" position="F" primary_position="NA" active="true" />
      </players>
   </team>
</game>

Player Statuses


What player statuses can I 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
  • DUP – Duplicate

What are the player experience values I can expect to see in the feeds?

  • FR – Freshman
  • SO – Sophomore
  • JR – Junior
  • SR – Senior
  • GR – Graduate Student

Schedules


How do I pull in schedule data for future games in which teams are not yet known?

This API features a TBD team used for every entry in to-be-determined matchups. This virtual team will have its own unique ID specific to this API.

Find the TBD team in the Teams endpoint.

  • <team id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" name="TBD" alias="TBD" market="Team"/>

The matchups will appear as below in the Schedule endpoints.

<series id="0f81bb4d-1d0c-4a3b-82de-507534154095" title="NBA Finals - TBD vs TBD" round="4" start_date="2024-06-06" status="scheduled">
  <games>
  <game id="342f103b-0fd7-47ac-a84d-1391e3605e96" status="time-tbd" title="Game 1" coverage="full" scheduled="2024-06-06T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    <time_zones/>
    <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
      </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="71d8d5fc-6836-43c1-85a0-61a828296a06" status="time-tbd" title="Game 2" coverage="full" scheduled="2024-06-09T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="50b170b9-37e2-47d0-b517-e56ebb960cba" status="time-tbd" title="Game 3" coverage="full" scheduled="2024-06-12T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="8e94445c-c223-4a49-a759-0b651e440b95" status="time-tbd" title="Game 4" coverage="full" scheduled="2024-06-14T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="aaa3ddb3-dd1b-459e-a686-d2bfc4408881" status="if-necessary" title="Game 5 (if necessary)" coverage="full" scheduled="2024-06-17T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="7c16f1ec-6629-4675-aaaa-2a31835862a6" status="if-necessary" title="Game 6 (if necessary)" coverage="full" scheduled="2024-06-20T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
<game id="09129676-2320-4151-976d-713ea785d97b" status="if-necessary" title="Game 7 (if necessary)" coverage="full" scheduled="2024-06-23T17:00:00+00:00" neutral_site="false" track_on_court="true" home_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6" away_team="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  <time_zones/>
  <home name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
    </home>
<away name="Team TBD" alias="TBD" id="907dc4e5-6957-4d19-b7d4-b1b7003b91e6">
  </away>
</game>
</games>
</series>


"series": [
  {
    "id": "0f81bb4d-1d0c-4a3b-82de-507534154095",
    "title": "NBA Finals - TBD vs TBD",
    "round": 4,
    "start_date": "2024-06-06",
    "status": "scheduled",
    "participants": [],
    "games": [
      {
        "id": "342f103b-0fd7-47ac-a84d-1391e3605e96",
        "status": "time-tbd",
        "title": "Game 1",
        "coverage": "full",
        "scheduled": "2024-06-06T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "71d8d5fc-6836-43c1-85a0-61a828296a06",
        "status": "time-tbd",
        "title": "Game 2",
        "coverage": "full",
        "scheduled": "2024-06-09T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "50b170b9-37e2-47d0-b517-e56ebb960cba",
        "status": "time-tbd",
        "title": "Game 3",
        "coverage": "full",
        "scheduled": "2024-06-12T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "8e94445c-c223-4a49-a759-0b651e440b95",
        "status": "time-tbd",
        "title": "Game 4",
        "coverage": "full",
        "scheduled": "2024-06-14T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "aaa3ddb3-dd1b-459e-a686-d2bfc4408881",
        "status": "if-necessary",
        "title": "Game 5 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-17T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "7c16f1ec-6629-4675-aaaa-2a31835862a6",
        "status": "if-necessary",
        "title": "Game 6 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-20T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      },
      {
        "id": "09129676-2320-4151-976d-713ea785d97b",
        "status": "if-necessary",
        "title": "Game 7 (if necessary)",
        "coverage": "full",
        "scheduled": "2024-06-23T17:00:00+00:00",
        "neutral_site": false,
        "track_on_court": true,
        "home": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        },
        "away": {
          "name": "Team TBD",
          "alias": "TBD",
          "id": "907dc4e5-6957-4d19-b7d4-b1b7003b91e6"
        }
      }
    ]
  },

Make note of the status attribute to determine whether the time of the game is known. A status of time-tbd indicates the game has been scheduled, but a time has yet to be announced. A status of scheduled indicates the game time is known.


Player Positions


What player positions can I expect to see?

  • NA
  • C
  • C-F
  • F
  • F-C
  • F-G
  • G
  • G-F

What player primary positions can I expect to see?

  • NA
  • C
  • PF
  • PG
  • SF
  • SG
<player id="d0c7135a-1aea-40cb-ba20-df656de71749" status="ACT" full_name="Anthony Edwards" 
  first_name="Anthony" last_name="Edwards" abbr_name="A.Edwards" height="76" weight="225" 
  position="G" primary_position="SG"

Shot Types


What shot type descriptions can I expect to see?

Jump Shot (This is the only shot type for 3-point attempts)

  • bank
  • driving
  • driving bank
  • driving floating
  • driving floating bank
  • turnaround
  • turnaround bank
  • turnaround fadeaway
  • turnaround fadeaway bank
  • floating
  • fadeaway
  • fadeaway bank
  • stepback
  • stepback bank
  • pullup
  • pullup bank
  • running
  • running pullup

Layup

  • alley-oop
  • cutting
  • cutting finger roll
  • driving
  • driving reverse
  • driving finger roll
  • finger roll
  • putback
  • reverse
  • running
  • running reverse
  • running finger roll
  • running alley-oop
  • tip

Dunk

  • alley-oop
  • tip
  • driving
  • driving reverse
  • putback
  • running
  • reverse
  • running reverse
  • running alley-oop
  • cutting

Tip Shot

Hook

  • bank
  • driving
  • driving bank
  • turnaround
  • turnaround bank

Event Types


What are the valid events types tracked in the Play-by-Play endpoint?

  • clearpathfoul - charged_to clear path foul (drawn_by draws the foul)
  • deadball - given_to rebound (deadball)
  • defensivethreeseconds - charged_to defensive 3 seconds violation
  • delay - charged_to delay of game violation
  • ejection - given_to ejected from the game
  • endperiod - End of nth period/half
  • flagrantone - charged_to flagrant 1 (drawn_by draws the foul)
  • flagranttwo - charged_to flagrant 2 (drawn_by draws the foul)
  • freethrowmade - taken_by makes free_throw_type free throw attempt
  • freethrowmiss - taken_by misses free_throw_type free throw attempt (charged_to lane_violation)
  • jumpball - Jump ball reason. possessor vs challenger (possession gains possession)
  • kickball - charged_to kicked ball violation
  • minortechnicalfoul - player_name technical foul
  • offensivefoul - charged_to offensive foul (drawn_by draws the foul)
  • officialtimeout - Official timeout
  • openinbound - Open inbound team_name
  • opentip - home vs away (possession gains possession)
  • personalfoul - charged_to personal foul (drawn_by draws the foul)
  • possession - possession gain possession
  • rebound - given_to offensive/defensive rebound
  • review - Play review (reason, outcome)
  • shootingfoul - charged_to shooting foul (drawn_by draws the foul)
  • teamtimeout - team_name duration second timeout
  • technicalfoul - charged_to technical foul (foul_type_desc)
  • 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
  • turnover - charged_to turnover (turnovertype_desc)
  • tvtimeout - TV Timeout
  • 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

Season & Period Types


What are the valid season types?

  • reg – Regular season
  • ct – Conference tournaments
  • pst – Post-season

What are the Period Types I can expect to see in the feeds?

  • half
  • overtime
  • quarter

Court Dimensions


What is the scale of the X Y coordinates?

The court we use is 1128 by 600. The scale is in inches.


Why does the team_basket attribution in the Play-by-Play endpoint not match the basket orientation (left vs. right) in the broadcast or game tracking?

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).


Neutral Site Games


How are home/away team designations determined for neutral site games, and are those designations consistent across Sportradar products?

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.

<game id="4f16ff1b-4b9e-4aea-918e-46fd6c129964" status="scheduled" coverage="full" scheduled="2020-12-21T03:00:00Z" 
  neutral_site="true" conference_game="true" home_team="e52c9644-717a-46f4-bf16-aeca000b3b44" away_team="9fccbf28-2858-4263-821c-fdefb3c7efa3">
   <time_zones venue="US/Pacific" home="US/Pacific" away="US/Mountain" />
   <venue id="8880a26a-485d-424f-a53f-bedae94b36ba" name="T-Mobile Arena" capacity="18000" address="3780 South Las Vegas Boulevard" 
    city="Paradise" state="NV" zip="89158" country="USA" />
   <home name="Washington Huskies" alias="WASH" id="e52c9644-717a-46f4-bf16-aeca000b3b44" />
   <away name="Colorado Buffaloes" alias="COLO" id="9fccbf28-2858-4263-821c-fdefb3c7efa3" />
   <broadcasts>
      <broadcast network="Pac-12 Network" type="TV" />
   </broadcasts>
</game>

The above sample 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 when we initially publish 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.

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.


Scoring


When are scores added to the schedule feeds?

Final scores are added to the schedule feeds when the game status changes to complete.


Efficiency Formulas


What formulas are used to calculate efficiency and efficiency game score?

Here are the formulas we use:

Efficiency: (Points + Rebounds + Assists + Steals + Blocks − Missed Field Goal Attempts − Missed Free Throw Attempts - Turnovers)

Efficiency Game Score: (Points) + (0.4_Field Goals Made) - (0.7_Field Goals Attempted) - (0.4_Free Throws Missed) + (0.7_Offensive Rebounds) + (0.3_Defensive Rebounds) + (Steals) + (0.7_Assists) + (0.7_Blocks) – (0.4_Personal Fouls) – (Turnovers)

Note: For this team efficiency calculations, statistics attributed to the team rather than a player are not counted (i.e. team rebounds, team turnovers, team fouls, etc.).


Standings & Rankings


When will the NET rankings for a season be available?

NET rankings will be released one month after the start of the season.



🙋

More questions?

Reach out to [email protected] for further assistance.

© Sportradar AG, St. Gallen, Switzerland