Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Game Play-by-Play

Unrivaled Game Play-by-Play provides detailed, real-time information on every team possession and game event.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache:

  • 60 seconds when a game is in scheduled status
  • 3 seconds when a game moves to inprogress
  • 600 seconds when a game moves to closed
  • 4 hours when seven days have passed since closed

Data Updates: Realtime

📘

Tracking Live Games

Learn how to use the Game Play-by-Play feed to capture every possession and game event in real time in our Tracking Live Games integration scenario.


Data Points

Browse this endpoint's available data points and their definitions below.

Season
AttributeParent ElementTypeDescription
idgame - seasonGUIDUnique season ID

ex. c86ab7c9-5408-44e6-af06-c22636262927
namegame - seasonStringName of the season

ex. Post-season
typegame - seasonStringType of the season

PRE, REG, OOT, PST
yeargame - seasonIntegerYear of the season
Boxscore
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game

Not typically used for Unrivaled
lead_changesgameIntegerNumber of lead changes in a game
times_tiedgameIntegerNumber of times tied in a game
lead_changesgame - quarter / elam - scoringIntegerNumber of lead changes in a quarter
times_tiedgame - quarter / elam - scoringIntegerNumber of times tied in a quarter
idelamGUIDUnique ID of Elam period

ex. 1c2463d7-43ec-4b83-a29c-d66087d8e8df
numberelamIntegerElam period number
sequenceelamIntegerPeriod sequence number (The Elam period sequence would be 4)
idquarterGUIDUnique ID of a quarter

ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725
numberquarterIntegerQuarter number
Game
AttributeParent ElementTypeDescription
away_teamgameGUIDUnique ID of the away team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
home_teamgameGUIDUnique ID of the home team

ex. a015b02d-845c-40c1-8ef4-844984f47e4d
entry_modegameStringType of data entry for the game

LDE (Live Data Entry by Sportradar)
clockgameStringClock value of the game

ex. 12:37
clock_decimalgameStringClock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as clock

ex. 00:21.70
clock_typegameStringType of clock value for an event

standard, elam
coveragegameStringCoverage level of a game

full, extended_boxscore (used for forfeit games only)
deletedgameBooleanSignifies a game was deleted when true
durationgameStringDuration of a game

ex. 2:26

Not typically used for Unrivaled
idgameGUIDUnique ID of a game

ex. f9d3aad2-45ac-4f65-8e75-734ac3de27eb
parent_idgameGUIDStandard parent ID of a game. Use this ID to group events (like the All-Star game) across seasons

ex. e4986bda-2f75-4228-8295-44b2449088b1
quartergameIntegerCurrent quarter of a game
statusgameStringThe status of a game

scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, postponed, time-tbd, if-necessary, unnecessary

Please see our FAQ section for a list of game status definitions
titlegameStringGame title

ex. Unrivaled Finals - Vinyl vs Rose
track_on_courtgameBooleanSignifies a game with tracking of players on the court.

When true, we provide a lineupchange event type, on_court player for Play-by-Play events, and an on_court indicator in Game Summary
neutral_sitegameBooleanSignifies a game played at a neutral venue

Not typically used for Unrivaled
scheduledgamedateTimeScheduled date and time of a game

ex. 2025-10-21T23:30:00+00:00
awaygame - time_zonesStringTime zone of the away team

ex. US/Pacific
homegame - time_zonesStringTime zone of the home team

ex. US/Eastern
venuegame - time_zonesStringTime zone of the venue

ex. US/Eastern
Broadcast
AttributeParent ElementTypeDescription
channelbroadcastStringName of a game's broadcast channel

ex. 642
localebroadcastStringSignifies the locale of a broadcast

ex. Home, Away, National
networkbroadcastStringName of a game's broadcast network

ex. TNT
typebroadcastStringType of broadcast

ex. TV or Internet
Play-by-Play - Attribution & Possession

Attribution is the team associated with the play-by-play event (i.e. the statistic associated with it). Possession is the team who currently has the possession of the ball as a result of that play-by-play event.

AttributeParent ElementTypeDescription
idevent - attributionGUIDUnique ID of a team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
marketevent - attributionStringMarket name of a team.

Not typically used for Unrivaled
nameevent - attributionStringTeam name

ex. Lunar Owls
team_basketevent - attributionStringThe basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective.

left, right
idevent - possessionGUIDUnique ID of a team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
marketevent - possessionStringMarket name of a team.

Not typically used for Unrivaled
nameevent - possessionStringTeam name

ex. Lunar Owls
team_basketevent - possessionStringThe basket the offensive team is shooting at in the arena. Direction is based on the TV broadcast's perspective.

left, right
Play-by-Play - Home/Away Teams
AttributeParent ElementTypeDescription
aliasscoring / quarter - awayStringAbbreviation of the away team

ex. LNR (Lunar Owls)
bonusgame - awayBooleanSignifies a team is in the bonus
pointsscoring - awayIntegerTotal points for the away team
pointsquarter - awayIntegerPoints in a quarter for the away team
idscoring / quarter - awayGUIDUnique ID of the away team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
marketscoring / quarter - awayStringMarket name of the away team

Not typically used for Unrivaled
namescoring / quarter - awayStringAway team name

ex. Lunar Owls
aliasscoring / quarter - homeStringAbbreviation of the home team

ex. LNR (Lunar Owls)
bonusgame - homeBooleanSignifies a team is in the bonus
pointsscoring - homeIntegerTotal points for the home team
pointsquarter - homeIntegerPoints in a quarter for the home team
idscoring / quarter - homeGUIDUnique ID of the home team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
marketscoring / quarter - homeStringMarket name of the home team

Not typically used for Unrivaled
namescoring / quarter - homeStringHome team name

ex. Lunar Owls
Play-by-Play - Event
AttributeParent ElementTypeDescription
attempteventStringText description of a free throw attempt

ex. 1 for 1, 1 for 2, 1 for 3
away_pointseventIntegerTotal points for the away team after an event
clockeventStringClock value of an event

ex. 12:37
clock_decimaleventStringClock value in decimal form when the game clock is under 1:00. Otherwise it displays the same value as clock

ex. 00:21.70
clock_directionaleventStringClock value during the Elam period. Time value counts upwards until the game concludes.

ex. +3:06
descriptioneventStringText description of an event

ex. Courtney Williams makes two point jump shot (Napheesa Collier assists)
event_typeeventStringType of event

ex. turnover or rebound

See our FAQ for a complete list of types
free_throw_typeeventStringType of free throw

ex. regular, technical, flagrant, clear path, weighted
home_pointseventIntegerTotal points for the home team after an event
ideventGUIDUnique ID of an event

ex. b9feda23-c03f-4304-afa4-06d7dc830651
action_areaevent - locationStringAction area of an event
coord_xevent - locationIntegerX coordinate of an event
coord_yevent - locationIntegerY coordinate of an event
rescindedeventBooleanSignifies a technical foul (event_type="technicalfoul") has been rescinded by the league when true
sequenceeventIntegerUNIX timestamp of an event. Use this value to help sequence play-by-play events (smallest to largest sequence number).

ex. 1678835426293
turnover_typeeventStringType of turnover

ex. Traveling or Lane Violation

See our FAQ for a complete list of types
createdeventdateTimeTimestamp of the creation of an event

ex. 2025-10-21T23:30:00+00:00
updatedeventdateTimeTimestamp of the last update to an event

ex. 2025-10-21T23:30:00+00:00
Play-by-Play - Play Participants & Stats
AttributeParent ElementTypeDescription
idevent - statistics - teamGUIDUnique ID of a team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
marketevent - statistics - teamStringMarket name of a team.

Not typically used for Unrivaled
nameevent - statistics - teamStringTeam name

ex. Lunar Owls
full_nameevent - statistics - playerStringFull name of a player

ex. Napheesa Collier
idevent - statistics - playerGUIDUnique player ID

ex. 100f94c5-3a62-4300-98bb-fe587522c2a6
jersey_numberevent - statistics - playerStringNumber of a player's jersey
madeevent - statistics - fieldgoalBooleanSignifies a made basket
pointsevent - statistics - fieldgoalIntegerNumber of points scored for an event
rebound_typeevent - statistics - reboundStringRebound type

defensive, offensive
shot_distanceevent - statistics - fieldgoalDecimalShot distance in feet from the basket

ex. 2.37
shot_typeevent - statistics - fieldgoalStringShot type

jump shot, layup, dunk, hook, tip
shot_type_descevent - statistics - fieldgoalStringText description of a shot type

ex. driving or alley-oop

See our FAQ for a complete list of descriptions
three_point_shotevent - statistics - fieldgoalBooleanSignifies a 3-point attempt
madeevent - statistics - freethrowBooleanSignifies a made free throw
pointsevent - statistics - freethrowIntegerNumber of points scored for a free throw
free_throw_typeevent - statistics - freethrowStringType of free throw

ex. regular, technical, flagrant, clear path, weighted
weighted_valueevent - statistics - freethrowStringNumber of points for a free throw attempt

one point, two point, three point
winning_basketevent - statistics - freethrowBooleanSignifies a game-winning free throw when true
winning_basketevent - statistics - fieldgoalBooleanSignifies a game-winning basket when true
Play-by-Play - On Court Participants
AttributeParent ElementTypeDescription
full_nameevent - on_court - playerStringFull name of a player

ex. Napheesa Collier
idevent - on_court - playerGUIDUnique player ID

ex. fd8d4b11-3d70-450a-b65c-016bec29cc9d
jersey_numberevent - on_court - playerStringNumber of a player's jersey
idevent - on_court - home / awayGUIDUnique ID of a team

ex. e5be75a6-cd4a-41d3-b3c3-638506ced50a
marketevent - on_court - home / awayStringMarket name of a team.

Not typically used for Unrivaled
nameevent - on_court - home / awayStringTeam name

ex. Lunar Owls
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
required
Defaults to 838316ea-ab7b-4581-a1dd-74229d1970d5

Unique Id of a game, found in a Schedule endpoint.

Example: 838316ea-ab7b-4581-a1dd-74229d1970d5

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json