USFL Game Play-by-Play provides a live play-by-play timeline, including possession and location information as well as all team and player statistics earned on each play.
Update FrequencyTTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime
Data Points
Boxscore:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attendance | game | Integer | Attendance of a game |
decision | away | String | Away team coin toss decisionkick , receive , defer |
direction | away | String | Away team coin toss direction chosen |
outcome | away | String | Away team coin toss outcomewon , lost |
points | away | Integer | Away team points in a quarter |
remaining_challenges | away | Integer | Away team challenges remaining |
remaining_timeouts | away | Integer | Away team timeouts remaining |
used_challenges | away | Integer | Away team challenges used |
used_timeouts | away | Integer | Away team timeouts used |
points | away | Integer | Away team total points |
clock | game | String | Clock value of the game |
quarter | coin_toss | String | Coin toss within a period. A coin toss will occur at the start of the game, half (period 3), and overtime |
decision | home | String | Home team coin toss decisionkick , receive , defer |
direction | home | String | Home team coin toss direction chosen |
outcome | home | String | Home team coin toss outcomewon , lost |
points | home | Integer | Home team points in a quarter |
remaining_challenges | home | Integer | Home team challenges remaining |
remaining_timeouts | home | Integer | Home team timeouts remaining |
used_challenges | home | Integer | Home team challenges used |
used_timeouts | home | Integer | Home team timeouts used |
points | home | Integer | Home team total points |
id | overtime | GUID | Overtime unique ID |
number | overtime | Integer | Overtime number |
sequence | overtime | Integer | Period sequence number (The first overtime sequence would be 5 ) |
quarter | game | Integer | Quarter number of a game |
id | quarter | GUID | Quarter unique ID |
number | quarter | Integer | Quarter number |
sequence | quarter | Integer | Period sequence number |
Game:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Away team alias |
|
| GUID | Unique ID of the away team |
|
| String | Away team market name |
|
| String | Away team name |
|
| String | Unique Sportradar ID of the away team |
|
| Boolean | Signifies an in-Conference matchup |
|
| String | Duration of the game |
|
| String | Type of data entry for the game |
|
| String | Home team alias |
|
| GUID | Unique ID of the home team |
|
| String | Home team market name |
|
| String | Home team name |
|
| String | Unique Sportradar ID of the home team |
|
| GUID | Unique ID of a game |
|
| Date/Time | Scheduled date and time of a game |
|
| String | Unique Sportradar ID of a game |
|
| String | Game status |
|
| String | Weather conditions for a game |
|
| Byte | Humid |
ty conditions for a game | |||
|
| Byte | Temperature of a game in Fahrenheit |
|
| String | Wind direction for a game |
|
| Byte | Wind speed for a game in MPH |
League:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | season | GUID | Unique season ID ex. 234f28d6-b9d7-4881-a890-30b451c13aec |
name | season | String | Name of the seasonPRE , REG , PST |
type | season | String | Type of the seasonPRE , REG , PST |
year | season | Integer | Year of the season |
id | week | GUID | Unique week ID ex. eb5f5b92-6a4e-42a7-b590-3f0ce7cc4736 |
sequence | week | Integer | Week sequence number |
title | week | String | Week title |
Play-by-Play Details:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Play detail category |
| String | Text description of a play | |
|
| String | Direction of action for a play |
|
| String | Team alias of the location of the ball at the conclusion of a play |
|
| Integer | Yardline location of the ball at the conclusion of a play |
|
| String | Indicates the yard line where the ball was first touched, after a fumble, but before the ball was recovered |
|
| String | Indicates a player should receive a statistical attempt for a play. Generally used on laterals |
|
| String | Indicates an onside kick |
|
| String | Text description of a penalty |
|
| String | Signifies a nullified play due to a penalty |
|
| String | Result of a penalty |
|
| Boolean | Indicates a play ending in a safety |
|
| Integer | Number of yards penalized on the play |
|
| String | Type of missed field goal attempt |
|
| String | Result of the play |
|
| String | Signifies a sack was split between two defendersWill not appear for games with |
|
| Integer | Sequence number of the play detail |
|
| String | Team alias of the location of the ball at the beginning of a play |
|
| Integer | Yardline location of the ball at the beginning of a play |
|
| Integer | Yards gained or lost on the play |
Play-by-Play Drive:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Date/Time | Timestamp of the start of a drive |
|
| String | Duration of a drive in |
|
| String | Game clock value at the end of a drive |
|
| String | End result of a drive |
|
| Integer | Number of first downs in a drive |
|
| Integer | Starting yardline of the first play of a drive (1-99 scale) |
|
| Integer | Number of yards gained in a drive |
|
| GUID | Unique ID of a drive |
|
| Boolean | Signifies a drive which ends inside the opponent's 20 yardline |
|
| Integer | Starting yardline of the last play of a drive (1-99 scale) |
|
| Integer | Net yards for the offensive team on a drive (Yards gained minus penalty yards) |
|
| Integer | Number of point after touchdown attempts on a drive |
|
| Boolean | Signifies a successful point after touchdown on a drive |
|
| Integer | Number of penalty yards on a drive |
|
| Integer | Number of plays in a drive |
|
| Boolean | Signifies a drive which ends in a score |
|
| Integer | Sequential number of the drive within a game |
|
| String | Game clock value at the start of a drive |
|
| String | Start reason of a drive |
|
| Integer | Sequential number of the drive for the offensive team |
|
| Date/Time | Timestamp of the last update of a drive |
|
| GUID | Unique ID of the defensive team for a drive |
|
| Integer | Number of points scored for the defensive team for a drive |
|
| GUID | Unique ID of the offensive team for a drive |
|
| Integer | Number of points scored for the offensive team for a drive |
Play-by-Play Ending Situation:
Attribute | Parent Element | Type | Description |
---|---|---|---|
clock | end_situation | String | Game clock value at the end of a play |
down | end_situation | Integer | Down at the end of a play |
alias | location | String | Team alias of the location of the ball at the end of a play ex. PIT (Pittsburgh) |
id | location | GUID | Unique team ID of the team with possession at the end of a play |
market | location | String | Team market name ex. Pittsburgh |
name | location | String | Team name ex. Maulers |
sr_id | location | GUID | Unique ID of a team ex. sr:competitor:882423 |
yardline | location | Integer | Yardline of the ball at the end of a play |
alias | possession | String | Team alias of the possession of the ball at the end of a play ex. PIT (Pittsburgh) |
id | possession | GUID | Unique team ID of the team with possession at the end of a play |
market | possession | String | Team market name ex. Pittsburgh |
name | possession | String | Team name ex. Maulers |
sr_id | possession | GUID | Unique ID of a team ex. sr:competitor:882423 |
yfd | end_situation | Integer | Yards to gain a first down at the end of a play |
Play-by-Play Event:
Attribute | Parent Element | Type | Description |
---|---|---|---|
clock | event | String | Clock value for an event ex. 12:37 |
created_at | event | Date/Time | Timestamp of the creation of an event ex. 2022-09-20T00:54:16+00:00 |
description | - | String | Text description of an event ex. TV Timeout |
id | event | String | Unique ID of an event ex. 34ced4e0-dca8-11ed-b2c7-9159d1dff79a |
sequence | event | Decimal | Sequence numer of events or plays. Used to sequence events properly ex. 1681685062673.0 |
type | event | String | Type of an eventsetup , timeout , tv_timeout , two_minute_warning , comment , period_end , game_over |
updated_at | event | Date/Time | Timestamp of the last update of an event ex. 2022-09-20T00:54:16+00:00 |
Play-by-Play Play:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| Integer | Away points at the end of a play |
|
| String | Clock value for a play |
|
| Date/Time | Timestamp of the creation of a play |
| String | Text description of a play | |
|
| Integer | Home points at the end of a play |
|
| GUID | Unique ID of a play |
|
| String | Direction of action for a play |
|
| Boolean | Indicates whether a play resulted in a score |
|
| Decimal | Sequence numer of events or plays. Used to sequence events properly |
|
| String | Type of play |
|
| Date/Time | Timestamp of the last update of a play |
|
| Date/Time | Timestamp of the start of the play/event entry |
Play-by-Play Points After:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | points-after-play | GUID | Unique ID of a point after attempt |
type | points-after-play | String | Type of a point after attemptextra_point , conversion , penalty |
sequence | points-after-play | Decimal | Sequence numer of events or plays. Used to sequence events properly |
Play-by-Play Quarter:
Attribute | Parent Element | Type | Description |
---|---|---|---|
id | quarter | GUID | Unique ID of a quarter |
number | quarter | Integer | Number of a quarter |
sequence | quarter | Integer | Sequential number of a quarter |
Play-by-Play Scoring:
Attribute | Parent Element | Type | Description |
---|---|---|---|
away_points | score | Integer | Number of away team points |
clock | score | Boolean | Clock value for a score ex. 12:37 |
home_points | score | Integer | Number of home team points |
points | score | Integer | Number of points for a score |
sequence | score | Integer | Sequence number of an event or play. Used to sequence events properly ex. 1665336878436.0 |
Play-by-Play Starting Situation:
Attribute | Parent Element | Type | Description |
---|---|---|---|
clock | start_situation | String | Clock value at the start of a play ex. 12:37 |
down | start_situation | Integer | Down at the start of a play |
alias | location | String | Team alias of the location of the ball at the start of a play ex. PIT (Pittsburgh) |
id | location | GUID | Unique team ID of the team with possession at the start of a play |
market | location | String | Team market name ex. Pittsburgh |
name | location | String | Team name ex. Maulers |
sr_id | location | GUID | Unique ID of a team ex. sr:competitor:882423 |
yardline | location | Integer | Yardline of the ball at the start of a play |
alias | possession | String | Team alias of the possession of the ball at the start of a play ex. PIT (Pittsburgh) |
id | possession | GUID | Unique team ID of the team with possession at the start of a play |
market | possession | String | Team market name ex. Pittsburgh |
name | possession | String | Team name ex. Maulers |
sr_id | possession | GUID | Unique ID of a team ex. sr:competitor:882423 |
yfd | end_situation | Integer | Yards to gain a first down at the start of a play |
Kick & Punt Block Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
block | block | Integer | Number kick blocks |
category | block | String | Type of blocked kickfield_goal , extra_point , punt |
Conversion Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | conversion | Integer | Number of conversion attempts |
category | conversion | String | Category of conversionpass , receive , rush , turnover |
complete | conversion | Integer | Number of conversion completions |
safety | conversion | Integer | Number of conversion safeties |
Defensive Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
ast_sack | defense | Integer | Number of assisted sacks |
ast_tackle | defense | Integer | Number of assisted tackles |
ast_tlost | defense | Integer | Number of assisted tackles for a loss |
block | defense | Integer | Number of blocked kicks/punts |
category | defense | String | Category of defensive statisticdefense , special_team , misc |
forced_fumble | defense | Integer | Number of forced fumbles |
interception | defense | Integer | Number of interceptions |
int_touchdown | defense | Integer | Number of interceptions for a touchdown |
int_yards | defense | Integer | Number of interception yards |
nullified | defense | Boolean | Nullified play flag |
pass_defended | defense | Integer | Number of passes defended |
primary | defense | Integer | Indicates whether the assist tackler was the primary tackler on a play *This stat is unsupported since 2021 |
qb_hit | defense | Integer | Number of hits on the quarterback |
sack | defense | Integer | Number of sacks |
sack_yards | defense | Integer | Number of sack yards |
safety | defense | Integer | Number of safeties |
tlost | defense | Integer | Number of tackles for a loss |
tlost_yards | defense | Integer | Number of tackles for a loss yardage |
tackle | defense | Integer | Number of tackles |
Defensive Conversion Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | defense_conversion | Integer | Number of defensive conversion attempts |
category | defense_conversion | String | Category of defensive conversionconversion , extra_point |
complete | defense_conversion | Integer | Number of defensive conversion completions |
Down Conversion Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | down_conversion | Integer | Number of down conversion attempts |
complete | down_conversion | String | Category of down conversionconversion , extra_point |
down | down_conversion | Integer | Number of the down at play start |
category | first_down | String | Type of first downpass , rush , penalty |
Extra Point Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | extra_point | Integer | Number of attempted extra points |
blocked | extra_point | Integer | Number of blocked extra points |
made | extra_point | Integer | Number of made extra points |
missed | extra_point | Integer | Number of missed extra points |
returned | extra_point | Integer | Number of returned extra points |
safety | extra_point | Integer | Number of extra point safeties |
Field Goal Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | field_goal | Integer | Number of attempted field goals |
att_yards | field_goal | Integer | Yardage of attempted field goal |
blocked | field_goal | Integer | Number of blocked field goals |
made | field_goal | Integer | Number of made field goals |
missed | field_goal | Integer | Number of missed field goals |
nullified | field_goal | Boolean | Signifies a nullified field goal attempt |
returned | field_goal | Integer | Number of returned field goals |
yards | field_goal | Integer | Yardage of made field goal |
Fumbles Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
forced | fumble | Integer | Number of forced fumbles |
fumble | fumble | Integer | Number of fumbles |
lost | fumble | Integer | Number of lost fumbles |
nullified | fumble | Boolean | Signifies a nullified play due to a penalty |
opp_rec | fumble | Integer | Number of opponent fumble recoveries |
opp_rec_td | fumble | Integer | Number of opponent fumble recovery touchdowns |
opp_rec_yards | fumble | Integer | Number of opponent fumble recovery yards |
out_of_bounds | fumble | Integer | Number of fumbles out of bounds |
own_rec | fumble | Integer | Number of own fumble recoveries |
own_rec_td | fumble | Integer | Number of own fumble recovery touchdowns |
own_rec_yards | fumble | Integer | Number of own fumble recovery yards |
play_category | fumble | String | Type of fumble ex. misc |
Kickoff Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | kick | Integer | Number of kickoff attempts |
endzone | kick | Integer | Number of kicks into the endzone |
inside_20 | kick | Integer | Number of kicks inside the 20 yardline |
net_yards | kick | Integer | Number of net yards on the kickoff |
nullified | kick | Boolean | Signifies a nullified play due to a penalty |
onside_attempt | kick | Boolean | Number of onside kickoff attempts |
onside_success | kick | Boolean | Number of onside kickoff successes |
own_rec | kick | Boolean | Number of own recoveries on a kickoff |
own_rec_td | kick | Boolean | Number of own recovery touchdowns on a kickoff |
touchback | kick | Boolean | Number of touchbacks |
yards | kick | Boolean | Number of kickoff yards |
Passing Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | pass | Integer | Number of pass attempts |
att_yards | pass | Integer | Number of pass attempt (air) yards, measured from the line of scrimmage to the yardline of the receiving target |
complete | pass | Integer | Number of pass completions |
firstdown | pass | Integer | Number of passing first downs |
goaltogo | pass | Integer | Number of plays in a goal-to-go situation |
inside_20 | pass | Integer | Number of passes inside the 20 yardline |
interception | pass | Integer | Number of interceptions thrown |
int_touchdown | pass | Integer | Number of interception touchdowns thrown |
nullified | pass | Boolean | Signifies a nullified play due to a penalty |
sack | pass | Integer | Number of sacks |
sack_yards | pass | Integer | Number of sack yards |
safety | pass | Integer | Number of safeties |
touchdown | pass | Integer | Number of touchdowns |
yards | pass | Integer | Number of passing yards |
Penalty Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
penalty | penalty | Integer | Number of penalties |
yards | penalty | Integer | Number of penalty yardage |
Punting Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | punt | Integer | Number of attempted punts |
blocked | punt | Integer | Number of blocked punts |
downed | punt | Integer | Number of downed punts |
endzone | punt | Integer | Number of punts into the endzone |
faircatch | punt | Integer | Number of fair catch punts |
inside_20 | punt | Integer | Number of punts inside the 20 yardline |
net_yards | punt | Integer | Net yardage of a punt |
nullified | punt | Boolean | Signifies a nullified play due to a penalty |
out_of_bounds | punt | Integer | Number of punts out of bounds |
touchback | punt | Integer | Number of touchback punts |
yards | punt | Integer | Yardage of punt |
Receiving Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
firstdown | receive | Integer | Number of receiving first downs |
goaltogo | receive | Integer | Number of receptions in goal-to-go |
inside_20 | receive | Integer | Number of receptions inside the 20 yardline |
nullified | receive | Boolean | Signifies a nullified play due to a penalty |
reception | receive | Integer | Number of receptions |
safety | receive | Integer | Number of receiving safeties |
targets | receive | Integer | Number of receiving targets |
touchdown | receive | Integer | Number of receiving touchdowns |
yards | receive | Integer | Number of receiving yards |
yards_after_catch | receive | Integer | Number of receiving yards after the catch |
Return Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
category | return | String | Type of returnpunt_return , kick_return |
downed | return | Integer | Number of returns downed |
faircatch | return | Integer | Number of return fair catches |
firstdown | return | Integer | Number of return first downs |
lateral | return | Integer | Number of return laterals |
nullified | return | Boolean | Signifies a nullified play due to a penalty |
out_of_bounds | return | Integer | Number of returns out of bounds |
play_category | return | String | Type of return playpunt_return , kick_return |
return | return | Integer | Number of returns |
touchback | return | Integer | Number of return touchbacks |
touchdown | return | Integer | Number of return touchdowns |
yards | return | Integer | Number of return yardage |
Rushing Play Statistics:
Attribute | Parent Element | Type | Description |
---|---|---|---|
attempt | rush | Integer | Number of rushing attempts |
firstdown | rush | Integer | Number of rushing first downs |
goaltogo | rush | Integer | Number of rushes in goal-to-go |
inside_20 | rush | Integer | Number of rushes inside the 20 yardline |
lateral | rush | Integer | Number of rushing laterals |
nullified | rush | Boolean | Signifies a nullified play due to a penalty |
safety | rush | Integer | Number of rushing safeties |
tlost | rush | Integer | Number of rushing tackles for a loss |
tlost_yards | rush | Integer | Number of rushing tackles for a loss yardage |
touchdown | rush | Integer | Number of rushing touchdowns |
yards | rush | Integer | Number of rushing yards |
Player:
Attribute | Parent Element | Type | Description |
---|---|---|---|
|
| String | Full name of a player |
|
| GUID | Unique ID of a player |
|
| Integer | Jersey number of a player |
|
| String | Position of a player |
|
| String | Role of a player during a specific play |
Standings:
Attribute | Parent Element | Type | Description |
---|---|---|---|
losses | record | Integer | Number of team losses year-to-date before the game. Record is updated post-game based on the game outcome |
ties | record | Integer | Number of team ties year-to-date before the game. Record is updated post-game based on the game outcome |
wins | record | Integer | Number of team wins year-to-date before the game. Record is updated post-game based on the game outcome |
Team:
Attribute | Parent Element | Type | Description |
---|---|---|---|
alias | team | String | Team alias ex. PIT |
id | team | GUID | Unique ID of a team ex. c8797380-9677-11ec-9193-6b32ce92fd29 |
market | team | String | Team market name ex. Pittsburgh |
name | team | String | Team name ex. Maulers |
sr_id | team | String | Unique Sportradar ID of a team ex. sr:competitor:882423 |
Venue:
Attribute | Parent Element | Type | Description |
---|---|---|---|
address | venue | String | Address of a venue ex. 1020 24th St N |
capacity | venue | Integer | Capacity of a venue ex. 47100 |
city | venue | String | City of a venue ex. Birmingham |
country | venue | String | Country of a venue ex. USA |
id | venue | GUID | Unique ID of a venue ex. b1f3fd20-90f4-11ec-bf38-efe8ff3d0b79 |
name | venue | String | Name of a venue ex. Protective Stadium |
roof_type | venue | String | Roof type of a venueoutdoor , dome , retractable_dome |
sr_id | venue | String | Unique Sportradar venue ID ex. sr:venue:58724 |
state | venue | String | State of a venue ex. AL |
surface | venue | String | Surface type of a venueturf , artificial |
zip | venue | Integer | ZIP code of a venue ex. 35203 |