NCAAWB FAQs

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

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

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

Note that, for select game-centric endpoints, the TTL may adjust when an event is live. This information is available for each endpoint on our developer portal.

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.
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.
created - The game has been created and we have begun logging information.
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).
unnecessary – The series game was scheduled to occur, but will not take place due to one team clinching the series early.
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.

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

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.

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.

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
DUP – Duplicate player profile

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

What post-season national tournaments do you cover?

We cover the NCAA National Tournament (March Madness), the WBI, WBIT, and WNIT. Here are the coverage levels for these tournaments:

March Madness – All games will be covered live via full coverage.
WBI – All games covered live, via Extended Boxscore coverage.
WBIT – All games covered live, via Extended Boxscore coverage.
WNIT – All games covered live, via Extended Boxscore coverage.

What is the scale of the X Y coordinates?

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

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

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
ejection
endperiod
flagrantone
flagranttwo
freethrowmade
freethrowmiss
jumpball
offensivefoul
officialtimeout
openinbound
opentip
personalfoul
possession
rebound
shootingfoul
teamtimeout
technicalfoul
threepointmade
threepointmiss
turnover
tvtimeout
twopointmade
twopointmiss

When we 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.

When are scores added to the schedule feeds?

A: Final scores are added to the schedule feeds when the game status changes to completed.

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="bff84116-0f9c-4a12-bdcb-1b088ee05fa6" status="time-tbd" coverage="boxscore" scheduled="2020-12-20T18:00:00Z" neutral_site="true"conference_game="false" home_team="6ea21006-7b5a-4ebb-8245-b880f529da2e" away_team="8849f362-1941-4632-b975-845e4baad656">
	<time_zones venue="US/Pacific" home="US/Pacific" away="US/Eastern"/>
	<venue id="94c90d45-9f8e-4f57-b071-868c8da54d79" name="South Point Arena" capacity="4600" address="9777 Las Vegas Boulevard" city="Las Vegas" state="NV" zip="89183" country="USA"/>
	<home name="Gonzaga Bulldogs" alias="GONZ" id="6ea21006-7b5a-4ebb-8245-b880f529da2e"/>
	<away name="Eastern Michigan Eagles" alias="EMU" id="8849f362-1941-4632-b975-845e4baad656"/>
</game>

As a result, this game will count towards Gonzaga's and Eastern Michigan'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 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.

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)

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

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.