get https://api.sportradar.com/usfl//v7//games//roster.
USFL Game Roster provides complete game roster information for each team, including game status and player profile data.
Update Frequency
TTL / 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 ex. 73242 |
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 ex. 12:37 |
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 |
quarter | game | Integer | Quarter number of the game |
Officials:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
assignment | official | String | Official assignment ex. linejudge or replayofficial |
full_name | official | String | Full name of an official ex. Larry Smith |
number | official | Integer | Jersey number of an official |
Draft:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
number | draft | Integer | Draft pick number of a player |
round | draft | Integer | Draft pick round of a player |
year | draft | Integer | Draft year of a player |
alias | draft - team | String | Draft team alias ex. PHI (Philadelphia) |
id | draft - team | GUID | Unique ID of a draft team ex. b786eb70-9677-11ec-9193-6b32ce92fd29 |
market | draft - team | String | Draft team market name ex. Philadelphia |
name | draft - team | String | Draft team name ex. Stars |
sr_id | draft - team | String | Unique Sportradar ID of a draft team ex. sr:competitor:882421 |
Game:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alias | away | String | Away team alias ex. NO (New Orleans) |
id | away | GUID | Unique ID of the away team ex. 51da96b0-9676-11ec-9ad0-d3ebe46bbb12 |
market | away | String | Away team market name ex. New Orleans |
name | away | String | Away team name ex. Breakers |
sr_id | away | String | Unique Sportradar ID of the away team ex. sr:competitor:882413 |
conference_game | game | Boolean | Signifies an in-Conference matchup |
coverage | game | String | Optional value that displays the coverage of a game ex. full |
duration | game | String | Duration of the game ex. 2:52 |
entry_mode | game | String | Type of data entry for the gameLDE (Live Data Entry) |
game_type | game | String | Type of gameregular, playoff |
alias | home | String | Home team alias ex. PIT |
id | home | GUID | Unique ID of the home team ex. c8797380-9677-11ec-9193-6b32ce92fd29 |
market | home | String | Home team market name ex. Pittsburgh |
name | home | String | Home team name ex. Maulers |
sr_id | home | String | Unique Sportradar ID of the home team ex. sr:competitor:882423 |
id | game | GUID | Unique ID of a game ex. 03aa477c-de6a-4d7a-90f4-97eed05f2e89 |
neutral_site | game | Boolean | Signifies a game is held at a neutral site |
scheduled | game | Date/Time | Scheduled date and time of a game ex. 2022-09-25T20:10:00+00:00 |
sr_id | game | String | Unique Sportradar ID of a game ex. sr:match:33623305 |
status | game | String | Game status scheduled, created, inprogress, halftime, complete, closed, cancelled, delayed, suspended, postponed, time-tbdSee our USFL FAQ for game status descriptions |
title | game | String | Game title ex. USFL Championship |
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 |
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr_name | player | String | Abbreviated name of a player ex. J.Crawford |
age | player | Integer | Age of a player at the time of the game |
birth_date | player | Date | Player date of birth ex. 1994-12-02 |
birth_place | player | String | Birthplace of a player ex. Deerfield Beach, FL, USA |
college | player | String | College attended ex. Illinois |
college_conf | player | String | College Conference ex. Big Ten Conference |
first_name | player | String | First name of a player ex. James |
name | player | String | Full name of a player ex. James Crawford |
height | player | Integer | Height in inches |
high_school | player | String | High school attended ex. St. Thomas Aquinas (FL) |
id | player | GUID | Unique ID of a player ex. 94b1aa60-b862-11ec-8d8f-9baa1b88fba4 |
in_game_status | player | String | In-game status of a player updated in real-timeactive, probable, questionable, doubtful, out, benched, unknown |
jersey | player | Integer | Jersey number of a player |
last_name | player | String | Last name of a player ex. Crawford |
name_suffix | player | String | Suffix of a player ex. Jr. |
position | player | String | Position of a player See our FAQ for a list of valid positions |
preferred_name | player | String | Preferred name of a player |
status | player | String | Game status of a playerdeactivated, dnp(Did Not Play), played, startedSee our FAQ for more info on these player game statuses |
weight | player | Decimal | Weight in lbs |
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 |
Coaches:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
first_name | home/away - coach | String | First name of a coach ex. John |
full_name | home/away - coach | String | Full name of a coach ex. John DeFilippo |
id | home/away - coach | GUID | Unique ID of a coach ex. 80675d40-6102-11ed-a6fd-cb7b3f097b25 |
last_name | home/away - coach | String | Last name of a coach ex. DeFilippo |
name_suffix | home/away - coach | String | Suffix of a coach ex. Jr. |
position | home/away - coach | String | Type of coach ex. Head Coach |
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 |