Categories

Coverage
Integration
Player Statuses
Shot Types
Season & Period Types
Neutral Site Games
Scoring

NCAA Tournament
Data Workflow
Game & Series Statuses
Schedules
Player Positions
Event Types
Court Dimensions

.

Coverage

How is each NCAA Women's Basketball game covered?

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

What post-season national tournaments do you cover?

🏀
Tournament Integration Guide
For detailed guidance on tracking NCAA Women's Tournaments and integrating with our tournament feeds, see our NCAA Women's Tournament Integration Guide .

Do NCAA Women's Basketball games include live player minutes?

No. NCAA Women’s Basketball does not provide live player-minute data; minutes are added only after the game.

For comparison, some NCAA Men’s Basketball games support live player-minute tracking when track_on_court="true". All NCAA Women’s Basketball games currently return track_on_court="false", meaning live player minutes are not available.

NCAA Tournament

When will the NCAA Tournament schedule be available?

The initial NCAA Tournament schedule will be released within 2 hours of the completion of the Selection Sunday telecast.

🏀
Tournament Integration Guide
For detailed guidance on tracking NCAA Women's Tournaments and integrating with our tournament feeds, see our NCAA Women's Tournament Integration Guide .

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?

Date values are presented in the ISO 8601 standard format.

Timestamp fields are in UTC. These could include scheduled start times or play-by-play event timestamps. Examples: scheduled="2024-02-11T23:30:00+00:00", created_at="2024-02-11T23:43:20+00:00"

Date-only fields reflect local league convention and are not UTC-adjusted. These could include season start dates and birth dates. Examples: start_date="2024-08-16", date_of_birth="1984-09-22"

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 NCAAWB 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.
forfeited – The game has been forfeited by one of the scheduled teams and is considered complete.

How do you handle forfeit games?

We mark a forfeit game with a status of forfeited and the winning team marked with forfeit_winner="true". See our Forfeit workflow for more info.

How do you define a team rebound?

A team rebound is recorded when no individual player is credited with a rebound following a missed field goal or free throw, but the team gains or is awarded possession of the ball.

Typical scenarios include:

The ball goes out of bounds after a missed shot without any player securing control
Possession is awarded after certain violations (e.g., lane violations, loose-ball fouls)
Simultaneous recovery situations where no single player can be identified as controlling the rebound

Every missed shot must result in either a player rebound or a team rebound to maintain statistical balance.

{
  "id": "287b808f-c78d-4dfc-b0a6-cc1b21a555ea",
  "clock": "10:13",
  "updated": "2025-10-16T01:36:06Z",
  "description": "Ryan Kalkbrenner misses two point tip layup",
  "wall_clock": "2025-10-15T23:12:54Z",
  "sequence": 1760569974300,
  "home_points": 5,
  "away_points": 4,
  "clock_decimal": "10:13",
  "created": "2025-10-15T23:16:43Z",
  "number": 41,
  "event_type": "twopointmiss",
  "qualifiers": [
      {
          "qualifier": "pointsinthepaint"
        },
      {
          "qualifier": "2ndchance"
        }
    ],
  "attribution": {
      "name": "Hornets",
      "market": "Charlotte",
      "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
      "team_basket": "left",
      "sr_id": "sr:team:3430",
      "reference": "1610612766"
    },
  "location": {
      "coord_x": 78,
      "coord_y": 313,
      "action_area": "underbasket"
    },
  "on_court": {
      "home": {
          "name": "Hornets",
          "market": "Charlotte",
          "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
          "sr_id": "sr:team:3430",
          "reference": "1610612766",
          "players": [
              {
                  "full_name": "LaMelo Ball",
                  "jersey_number": "1",
                  "id": "be53f27f-c666-4bd2-8fcd-0713f963aa2b",
                  "sr_id": "sr:player:1875466",
                  "reference": "1630163"
                },
              {
                  "full_name": "Kon Knueppel",
                  "jersey_number": "7",
                  "id": "0b9a642d-d6f6-4c65-a7bd-d82e016e1b5d",
                  "sr_id": "sr:player:2838879",
                  "reference": "1642851"
                },
              {
                  "full_name": "Miles Bridges",
                  "jersey_number": "0",
                  "id": "af8f331b-96a6-416e-8837-b14d5b11c52d",
                  "sr_id": "sr:player:1158306",
                  "reference": "1628970"
                },
              {
                  "full_name": "Ryan Kalkbrenner",
                  "jersey_number": "11",
                  "id": "388ec80d-171a-48f7-9cc8-5a8bebde54e0",
                  "sr_id": "sr:player:2075373",
                  "reference": "1641750"
                },
              {
                  "full_name": "Brandon Miller",
                  "jersey_number": "24",
                  "id": "775e4450-cdcd-43a1-b4cd-dc29fba48503",
                  "sr_id": "sr:player:2438503",
                  "reference": "1641706"
                }
            ]
        },
      "away": {
          "name": "Grizzlies",
          "market": "Memphis",
          "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
          "sr_id": "sr:team:3415",
          "reference": "1610612763",
          "players": [
              {
                  "full_name": "Jaylen Wells",
                  "jersey_number": "0",
                  "id": "f2d36d30-3544-41cb-831d-afec9e256418",
                  "sr_id": "sr:player:2492961",
                  "reference": "1642377"
                },
              {
                  "full_name": "Javon Small",
                  "jersey_number": "10",
                  "id": "d1951755-732a-453b-bede-69ff9e5a595c",
                  "sr_id": "sr:player:2218444",
                  "reference": "1642914"
                },
              {
                  "full_name": "Jaren Jackson Jr.",
                  "jersey_number": "8",
                  "id": "3e492a6a-ed3c-499d-b3f5-ff68ca16f6fd",
                  "sr_id": "sr:player:1316824",
                  "reference": "1628991"
                },
              {
                  "full_name": "Jock Landale",
                  "jersey_number": "31",
                  "id": "02dc6e18-95a4-4919-b4fc-f8a981ccd359",
                  "sr_id": "sr:player:1159256",
                  "reference": "1629111"
                },
              {
                  "full_name": "Kentavious Caldwell-Pope",
                  "jersey_number": "3",
                  "id": "cecc054e-b9ec-4c71-8bbb-5ee665a8c3a9",
                  "sr_id": "sr:player:608182",
                  "reference": "203484"
                }
            ]
        }
    },
  "statistics": [
      {
          "type": "fieldgoal",
          "made": false,
          "shot_type": "layup",
          "shot_type_desc": "tip",
          "shot_distance": 1.65,
          "team": {
              "name": "Hornets",
              "market": "Charlotte",
              "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
              "sr_id": "sr:team:3430",
              "reference": "1610612766"
            },
          "player": {
              "full_name": "Ryan Kalkbrenner",
              "jersey_number": "11",
              "id": "388ec80d-171a-48f7-9cc8-5a8bebde54e0",
              "sr_id": "sr:player:2075373",
              "reference": "1641750"
            }
        }
    ]
},
{
  "id": "a908bef6-b62a-4bd7-b66d-f862e6942e32",
  "clock": "10:13",
  "updated": "2025-10-16T01:36:06Z",
  "description": "Hornets offensive rebound",
  "wall_clock": "2025-10-15T23:12:54Z",
  "sequence": 1760569974300,
  "home_points": 5,
  "away_points": 4,
  "clock_decimal": "10:13",
  "created": "2025-10-15T23:16:43Z",
  "number": 42,
  "event_type": "rebound",
  "qualifiers": [
      {
          "qualifier": "team"
        }
    ],
  "attribution": {
      "name": "Hornets",
      "market": "Charlotte",
      "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
      "team_basket": "left",
      "sr_id": "sr:team:3430",
      "reference": "1610612766"
    },
  "location": {
      "coord_x": 78,
      "coord_y": 313,
      "action_area": "underbasket"
    },
  "possession": {
      "name": "Hornets",
      "market": "Charlotte",
      "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
      "sr_id": "sr:team:3430",
      "reference": "1610612766"
    },
  "on_court": {
      "home": {
          "name": "Hornets",
          "market": "Charlotte",
          "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
          "sr_id": "sr:team:3430",
          "reference": "1610612766",
          "players": [
              {
                  "full_name": "LaMelo Ball",
                  "jersey_number": "1",
                  "id": "be53f27f-c666-4bd2-8fcd-0713f963aa2b",
                  "sr_id": "sr:player:1875466",
                  "reference": "1630163"
                },
              {
                  "full_name": "Kon Knueppel",
                  "jersey_number": "7",
                  "id": "0b9a642d-d6f6-4c65-a7bd-d82e016e1b5d",
                  "sr_id": "sr:player:2838879",
                  "reference": "1642851"
                },
              {
                  "full_name": "Miles Bridges",
                  "jersey_number": "0",
                  "id": "af8f331b-96a6-416e-8837-b14d5b11c52d",
                  "sr_id": "sr:player:1158306",
                  "reference": "1628970"
                },
              {
                  "full_name": "Ryan Kalkbrenner",
                  "jersey_number": "11",
                  "id": "388ec80d-171a-48f7-9cc8-5a8bebde54e0",
                  "sr_id": "sr:player:2075373",
                  "reference": "1641750"
                },
              {
                  "full_name": "Brandon Miller",
                  "jersey_number": "24",
                  "id": "775e4450-cdcd-43a1-b4cd-dc29fba48503",
                  "sr_id": "sr:player:2438503",
                  "reference": "1641706"
                }
            ]
        },
      "away": {
          "name": "Grizzlies",
          "market": "Memphis",
          "id": "583eca88-fb46-11e1-82cb-f4ce4684ea4c",
          "sr_id": "sr:team:3415",
          "reference": "1610612763",
          "players": [
              {
                  "full_name": "Jaylen Wells",
                  "jersey_number": "0",
                  "id": "f2d36d30-3544-41cb-831d-afec9e256418",
                  "sr_id": "sr:player:2492961",
                  "reference": "1642377"
                },
              {
                  "full_name": "Javon Small",
                  "jersey_number": "10",
                  "id": "d1951755-732a-453b-bede-69ff9e5a595c",
                  "sr_id": "sr:player:2218444",
                  "reference": "1642914"
                },
              {
                  "full_name": "Jaren Jackson Jr.",
                  "jersey_number": "8",
                  "id": "3e492a6a-ed3c-499d-b3f5-ff68ca16f6fd",
                  "sr_id": "sr:player:1316824",
                  "reference": "1628991"
                },
              {
                  "full_name": "Jock Landale",
                  "jersey_number": "31",
                  "id": "02dc6e18-95a4-4919-b4fc-f8a981ccd359",
                  "sr_id": "sr:player:1159256",
                  "reference": "1629111"
                },
              {
                  "full_name": "Kentavious Caldwell-Pope",
                  "jersey_number": "3",
                  "id": "cecc054e-b9ec-4c71-8bbb-5ee665a8c3a9",
                  "sr_id": "sr:player:608182",
                  "reference": "203484"
                }
            ]
        }
    },
  "statistics": [
      {
          "type": "rebound",
          "rebound_type": "offensive",
          "team": {
              "name": "Hornets",
              "market": "Charlotte",
              "id": "583ec97e-fb46-11e1-82cb-f4ce4684ea4c",
              "sr_id": "sr:team:3430",
              "reference": "1610612766"
            }
        }
    ]
},

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.

Note: In some schedule examples, you may see track_on_court="true" as shown above. NCAA Women's Basketball does not provide live player minutes for any game. Minutes are provided after the 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
TP – Player is in the Transfer Portal

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

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 (turnover_type_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

Court Dimensions

What is the scale of the X Y coordinates?

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

What x/y vertices define action areas in the x/y coordinate graph?

A list of areas is included below. Note that these vertices are for the left side of the court. For the right side, we use the following calculation, where length=1128 and width=600:

right-court-point = (length - x, width - y)
left_basket=[63, 300]
right_basket=[1065, 300]

Areas:

underbasket: [ 48, 252 ], [ 64, 252 ], [ 80, 255 ], [ 94, 263 ], [ 105, 276 ], [ 111, 292 ], [ 111, 308 ], [ 105, 324 ], [ 94, 337 ], [ 80, 345 ], [ 64, 348 ], [ 48, 348 ]
inthepaint: [ 0, 227 ], [ 228, 227 ], [ 228, 371 ], [ 0, 371 ]
insiderightwing: [ 0, 40 ], [ 118, 40 ], [ 78, 227 ], [ 0, 227 ]
insideright: [ 118, 40 ], [ 160, 53 ], [ 200, 72 ], [ 239, 101 ], [ 265, 127 ], [ 290, 161 ], [ 299, 179 ], [ 228, 227 ], [ 228, 227 ], [ 78, 227 ]
insidecenter: [ 228, 227 ], [ 299, 179 ], [ 312, 207 ], [ 321, 237 ], [ 327, 268 ], [ 329, 299 ], [ 327, 331 ], [ 322, 361 ], [ 313, 391 ], [ 300, 420 ], [ 228, 371 ]
insideleft: [ 228, 371 ], [ 228, 371 ], [ 300, 420 ], [ 290, 438 ], [ 265, 472 ], [ 240, 498 ], [ 200, 528 ], [ 160, 547 ], [ 118, 560 ], [ 78, 371 ]
insideleftwing: [ 0, 560 ], [ 118, 560 ], [ 78, 371 ], [ 0, 371 ]
outsiderightwing: [ 0, 0 ], [ 126, 0 ], [ 118, 40 ], [ 0, 40 ]
outsideright: [ 126, 0 ], [ 564, 0 ], [ 299, 179 ], [ 290, 161 ], [ 265, 127 ], [ 239, 101 ], [ 200, 72 ], [ 160, 53 ], [ 118, 40 ]
outsidecenter: [ 299, 179 ], [ 564, 0 ], [ 564, 600 ], [ 300, 420 ], [ 313, 391 ], [ 322, 361 ], [ 327, 331 ], [ 329, 299 ], [ 327, 268 ], [ 321, 237 ], [ 312, 207 ]
outsideleft: [ 126, 600 ], [ 564, 600 ], [ 300, 420 ], [ 290, 438 ], [ 265, 472 ], [ 240, 498 ], [ 200, 528 ], [ 160, 547 ], [ 118, 560 ]
outsideleftwing: [ 0, 600 ], [126, 600 ], [ 118, 560 ], [ 0, 560 ]
backcourt: [ 564, 0 ], [ 1128 , 0 ], [ 1128, 600 ], [ 564, 600 ]

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