Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Game Play-by-Play

NCAAFB 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 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:
AttributeParent ElementTypeDescription
attendancegameIntegerAttendance of a game
ex. 73242
decisioncoin_toss - awayStringAway team coin toss decision
kick, receive, defer
directioncoin_toss - awayStringAway team coin toss direction chosen
kick, receive, defer
outcomecoin_toss - awayStringAway team coin toss outcome
won, lost
pointsquarter - scoring - awayIntegerAway team points in a quarter
remaining_challengesawayIntegerAway team challenges remaining
remaining_timeoutsawayIntegerAway team timeouts remaining
used_challengesawayIntegerAway team challenges used
used_timeoutsawayIntegerAway team timeouts used
pointsawayIntegerAway team total points
clockgameStringClock value of the game
ex. 12:37
quartercoin_tossStringCoin toss within a period. A coin toss will occur at the start of the game, half (period 3), and overtimes (periods 5+)
decisioncoin_toss - homeStringHome team coin toss decision
defer, receive
directioncoin_toss - homeStringHome team coin toss direction chosen
kick, receive
outcomecoin_toss - homeStringHome team coin toss outcome
won, lost
pointsquarter - scoring - homeIntegerHome team points in a quarter
remaining_challengeshomeIntegerHome team challenges remaining
remaining_timeoutshomeIntegerHome team timeouts remaining
used_challengeshomeIntegerHome team challenges used
used_timeoutshomeIntegerHome team timeouts used
pointshomeIntegerHome team total points
idovertimeGUIDUnique ID of overtime
numberovertimeIntegerOvertime number
sequenceovertimeIntegerPeriod sequence number (The first overtime sequence would be 5)
quartergameIntegerQuarter number of the game
idquarterGUIDUnique ID of a quarter
ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725
numberquarterIntegerQuarter number
sequencequarterIntegerPeriod sequence number
Game:

Attribute

Parent Element

Type

Description

alias

away

String

Away team alias
ex. TCU (Texas Christian University)

id

away

GUID

Unique ID of the away team
ex. a09e634d-39a8-4aa8-81a4-7337580a31f4

market

away

String

Away team market name
ex. TCU

name

away

String

Away team name
ex. Horned Frogs

cable

broadcast

String

Number of a game's broadcast cable station
ex. 822

internet

broadcast

String

Name of a game's internet stream
ex. ESPN+

network

broadcast

String

Name of a game's broadcast network
ex. Amazon Prime Video

radio

broadcast

String

Name of a game's radio station
ex. Sirius 134, XM 231

satellite

broadcast

String

Name of a game's broadcast satellite station
ex. ESPN Ocho

conference_game

game

Boolean

Signifies an in-Conference matchup
ex. (SEC vs. SEC)

coverage

game

String

Coverage level of a game
full, extended_boxscore

duration

game

String

Duration of a game
ex. 2:52

entry_mode

game

String

Type of data entry for the game
LDE (Live Data Entry)

expected_latency

game

Integer

The time in seconds a game is expected to be behind real-time play on the field, with possible values of 2, 10, 25, and 50. For example, a value of 10 indicates a game is 10 or more seconds behind real-time, but less than 25.

Latency values are made available one day before gameday, though they are subject to change on gameday itself.

2, 10, 25, 50

game_type

game

String

Type of game
regular, conference_championship, bowl, playoff

alias

home

String

Home team alias
ex. UGA (University of Georgia)

id

home

GUID

Unique ID of the home team
ex. 2eef738d-c637-4b12-b8df-4b79efcce71e

market

home

String

Home team market name
ex. Georgia

name

home

String

Home team name
ex. Bulldogs

id

game

GUID

Unique ID of a game
ex. c9686716-f48a-4667-996d-97639429d8c3

neutral_site

game

Boolean

Signifies a game is held at a neutral site

playoff_game_type

game

String

Name of a playoff game type

See our FAQ for a list of valid playoff game types

parent_id

game

GUID

Standard parent ID of a game. Use this ID to group events (like bowl games) across seasons.

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:38354639

status

game

String

Game status
scheduled, created, inprogress, halftime, complete, closed, cancelled, postponed, delayed, suspended, flex-schedule, time-tbd

See our NCAAFB FAQ for game status descriptions

title

game

String

Game title
ex. CFP National Championship

away

time_zones

String

Time zone of the away team
ex. US/Pacific

home

time_zones

String

Time zone of the home team
ex. US/Eastern

venue

time_zones

String

Time zone of the venue
ex. US/Eastern

condition

weather

String

Weather condition for a game
ex. Partly cloudy, Clear, Light Rain, Mist

Click here for more info on weather condition values

humidity

weather

Byte

Humidity conditions for a game
ex. 44

temp

weather

Byte

Temperature of a game in Fahrenheit
ex. 57

direction

wind

String

Wind direction for a game
ex. N

speed

wind

Byte

Wind speed for a game in MPH

League:
AttributeParent ElementTypeDescription
idseasonGUIDUnique season ID
ex. ff53e5e4-10ef-4842-a0b7-b489956fa07e
nameseasonStringName of the season
REG
typeseasonStringType of the season
REG
yearseasonIntegerYear of the season
idweekGUIDUnique week ID
ex. c5b272b0-388f-496d-ab6f-0a341b0a116b
sequenceweekIntegerWeek sequence number
titleweekStringWeek title
ex. 10
Play-by-Play Details:

Attribute

Parent Element

Type

Description

category

detail

String

Play detail category
ex. kick_off, kick_off_return, tackle, rush

description

String

Text description of a play

direction

detail

String

Direction of action for a play
Rush: short left, short right, short middle, deep right, deep left, deep middle, left, right, middle
Pass: backward pass, handoff, lateral, reverse, left tackle, left guard, up the middle, right guard, right tackle, right end, left end, kneels

alias

end_location

String

Team alias of the location of the ball at the conclusion of a play
ex. UGA (University of Georgia)

yardline

end_location

Integer

Yardline location of the ball at the conclusion of a play
ex. 45

description

penalty

String

Text description of a penalty
ex. PENALTY on TCU-T.Hodges-Tomlinson, Defensive Pass Interference, 15 yards, accepted.

result

penalty

String

Result of a penalty
accepted, declined, offset

yards

penalty

Integer

Number of yards penalized on the play

result

detail

String

Result of the play
ex. tackled, touchdown

sequence

detail

Integer

Sequence number of the play detail

alias

start_location

String

Team alias of the location of the ball at the beginning of a play
ex. UGA (University of Georgia)

yardline

start_location

Integer

Yardline location of the ball at the beginning of a play
ex. 45

yards

detail

Integer

Yards gained or lost on the play

Play-by-Play Details - Review:

Attribute

Parent Element

Type

Description

result

detail - review

String

Result of a play review/challenge
overturned, upheld

reversed

detail - review

Boolean

Signifies the call on the field was reversed when true

type

detail - review

String

Type of a play review/challenge
ex. first down, pass completion, short of the line to gain

See our FAQ for a complete list of valid types.

alias

detail - review - team

String

Alias of a team initiating a review/challenge
ex. IOW (University of Iowa)

id

detail - review - team

GUID

Unique ID of a team initiating a review/challenge
ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1

market

detail - review - team

String

Market name of a team initiating a review/challenge
ex. Iowa

name

detail - review - team

String

Name of a team initiating a review/challenge
ex. Hawkeyes

Play-by-Play Details - Recovery:
AttributeParent ElementTypeDescription
typedetail - recoveryStringType of recovery
ball out of bounds, blocked kick recovery, dead ball declared, fumble recovery, interception, other team, other_team, same player, same team
aliasdetail - recovery - teamStringAlias of a team recovering the ball
ex. IOW (University of Iowa)
iddetail - recovery - teamGUIDUnique ID of a team recovering the ball
ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1
marketdetail - recovery - teamStringMarket name of a team recovering the ball
ex. Iowa
namedetail - recovery - teamStringName of a team recovering the ball
ex. Hawkeyes
Play-by-Play Drive:

Attribute

Parent Element

Type

Description

created_at

drive

Date/Time

Timestamp of the start of a drive
ex. 2023-01-01T02:10:21+00:00

id

drive - defensive_team

GUID

Unique ID of the defensive team on a drive
ex. 2eef738d-c637-4b12-b8df-4b79efcce71e

points

drive - defensive_team

Integer

Number of points scored for the defensive team on a drive

id

drive - offensive_team

GUID

Unique ID of the defensive team on a drive
ex. 2eef738d-c637-4b12-b8df-4b79efcce71e

points

drive - offensive_team

Integer

Number of points scored for the defensive team on a drive

duration

drive

String

Duration of a drive in MM:SS format

end_clock

drive

String

Clock value at the end of a drive
ex. 6:07

end_reason

drive

String

End result of a drive
ex. Touchdown

See our FAQ for a list of valid end reasons and their definitions

farthest_drive_yardline

drive

Integer

The furthest yardline the offensive team reached during a drive (1-99 scale)

first_downs

drive

Integer

Number of first downs in a drive

first_drive_yardline

drive

Integer

Starting yardline of the first play of a drive (1-99 scale)

gain

drive

Integer

Number of yards gained in a drive

id

drive

GUID

Unique ID of a drive

inside_20

drive

Boolean

Signifies a drive which ends inside the opponent's 20 yardline

last_drive_yardline

drive

Integer

Starting yardline of the last play of a drive (1-99 scale)

net_yards

drive

Integer

Net yards gained on a drive

pat_points_attempted

drive

Integer

Number of PAT points attempted on a drive

pat_points_attempted

drive

Integer

Number of PAT points attempted on a drive

pat_successful

drive

Boolean

Signifies a successful PAT attempt on a drive

penalty_yards

drive

Integer

Number of penalty yards on a drive

play_count

drive

Integer

Number of plays in a drive

scoring_drive

drive

Boolean

Signifies a drive which ends in a score

sequence

drive

Integer

Sequential number of the drive within a game

start_clock

drive

String

Clock value at the beginning of a drive
ex. 6:07

start_reason

drive

String

Start reason of a drive
ex. Interception

See our FAQ for a list of valid start reasons and their definitions

team_sequence

drive

Integer

Sequential number of a drive for the offensive team

updated_at

drive

Date/Time

Timestamp of the last update of a drive
ex. 2023-01-01T04:04:45+00:00

Play-by-Play Ending Situation:
AttributeParent ElementTypeDescription
clockend_situationStringGame clock value at the end of a play
ex. 14:55
downend_situationIntegerDown at the end of a play
aliasend_situation - locationStringTeam alias of the location of the ball at the end of a play
ex. UGA (University of Georgia)
idend_situation - locationGUIDUnique team ID of the team with possession at the end of a play
ex. 2eef738d-c637-4b12-b8df-4b79efcce71e
marketend_situation - locationStringTeam market name
ex. Georgia
nameend_situation - locationStringTeam name
ex. Bulldogs
yardlineend_situation - locationIntegerYardline of the ball at the end of a play
aliasend_situation - possessionStringTeam alias of the possession of the ball at the end of a play
ex. UGA (University of Georgia)
idend_situation - possessionGUIDUnique team ID of the team with possession at the end of a play
ex. 2eef738d-c637-4b12-b8df-4b79efcce71e
marketend_situation - possessionStringTeam market name
ex. Georgia
nameend_situation - possessionStringTeam name
ex. Bulldogs
yfdend_situationIntegerYards to gain a first down at the end of a play
Play-by-Play Event:
AttributeParent ElementTypeDescription
clockeventStringClock value for an event
ex. 12:37
created_ateventDate/TimeTimestamp of the creation of an event
ex. 2022-09-20T00:54:16+00:00
description-StringText description of an event
ex. End Game
ideventStringUnique ID of an event
ex. cfb655f0-909a-11ed-aba5-e52871d6dcff
sequenceeventDecimalSequence number of an event or play. Used to sequence events properly
ex. 1665336878436.0
typeeventStringType of an event
setup, timeout, tv_timeout, two_minute_warning, comment, period_end, game_over
updated_ateventDate/TimeTimestamp of the last update of an event
ex. 2022-09-20T00:54:16+00:00
wall_clockeventDate/TimeTimestamp of a play/event entry
ex. 2022-10-09T17:12:08+00:00
Play-by-Play - Play:
AttributeParent ElementTypeDescription
away_pointsplayIntegerAway points at the end of a play
clockplayStringClock value for a play
ex. 12:37
created_atplayDate/TimeTimestamp of the creation of a play
ex. 2022-09-20T00:54:16+00:00
description-StringText description of a play
ex. C.Stroud scrambles to UGA 31 for 27 yards. Tackled by D.Daniel-Sisavanh at UGA 31.
fake_field_goalplayBooleanSignifies whether the a play was a fake field goal
fake_puntplayBooleanSignifies whether the a play was a fake punt
goaltogoplayBooleanSignifies a play was goal-to-go (eg. 1st & Goal, 2nd & Goal, etc.) when true
home_pointsplayIntegerHome points at the end of a play
idplayGUIDUnique ID of a play
ex. 3ad11b50-898d-11ed-aacf-3187fb36aa01
officialplayBooleanSignifies whether or not a play is under review. If false, the play is currently under review. If true, a determination on the play has been made.
scoring-description-StringText description of a scoring play
ex. S.Bennett rushed left end to TCU End Zone for 21 yards. S.Bennett for 21 yards, TOUCHDOWN.
scoring_playplayBooleanSignifies whether a play resulted in a score
sequenceplayDecimalSequence number of an event or play. Used to sequence events properly
ex. 1665336878436.0
typeplayStringType of play
pass, rush, faircatch_kick, extra_point, conversion, free_kick, kickoff, punt, field_goal, penalty
updated_atplayDate/TimeTimestamp of the last update of a play
ex. 2022-09-20T00:54:16+00:00
wall_clockplayDate/TimeTimestamp of the start of the play/event entry
ex. 2022-10-09T17:12:08+00:00
Play-by-Play Points After:
AttributeParent ElementTypeDescription
idpoints-after-playGUIDUnique ID of a point after attempt
ex. a397a7c0-47f8-11ed-972d-8539f16b8bbf
typepoints-after-playStringType of a point after attempt
extra_point, conversion, penalty
sequencepoints-after-playDecimalSequence number of an event or play. Used to sequence events properly
ex. 1665336878436.0
Play-by-Play Quarter:
AttributeParent ElementTypeDescription
idquarterGUIDUnique ID of a quarter
ex. 47091cc4-08c2-4f83-9d8d-59c3c85e1725
numberquarterIntegerNumber of a quarter
sequencequarterIntegerSequential number of a quarter
idovertimeGUIDUnique ID of overtime
numberovertimeIntegerOvertime number
sequenceovertimeIntegerPeriod sequence number (The first overtime sequence would be 5)
Play-by-Play Scoring:
AttributeParent ElementTypeDescription
away_pointsscoreIntegerNumber of away team points
clockscoreBooleanClock value for a score
ex. 12:37
home_pointsscoreIntegerNumber of home team points
pointsscoreIntegerNumber of points for a score
sequencescoreIntegerSequence number of an event or play. Used to sequence events properly
ex. 1665336878436.0
Play-by-Play Starting Situation:
AttributeParent ElementTypeDescription
clockstart_situationStringClock value at the start of a play
ex. 12:37
downstart_situationIntegerDown at the start of a play
aliaslocationStringTeam alias of the location of the ball at the start of a play
ex. OSU (Ohio State University)
idstart_situation - locationGUIDUnique team ID of the team with possession at the start of a play
ex. 9a6d6f3f-021e-4ddd-8fac-ac4766239d87
marketstart_situation - locationStringTeam market name
ex. Ohio State
namestart_situation - locationStringTeam name
ex. Buckeyes
yardlinestart_situation - locationIntegerYardline of the ball at the start of a play
aliasstart_situation - possessionStringTeam alias of the possession of the ball at the start of a play
ex. OSU (Ohio State University)
idstart_situation - possessionGUIDUnique team ID of the team with possession at the start of a play
ex. 9a6d6f3f-021e-4ddd-8fac-ac4766239d87
marketstart_situation - possessionStringTeam market name
ex. Ohio State
namestart_situation - possessionStringTeam name
ex. Buckeyes
yfdend_situationIntegerYards to gain a first down at the start of a play
Kick & Punt Block Play Statistics:
AttributeParent ElementTypeDescription
blockblockIntegerNumber kick blocks
categoryblockStringType of blocked kick
field_goal, extra_point, punt
nullifiedblockBooleanSignifies the statisic is nullified
Conversion Play Statistics:
AttributeParent ElementTypeDescription
attemptconversionIntegerNumber of conversion attempts
categoryconversionStringCategory of conversion
pass, receive, rush, turnover
completeconversionIntegerNumber of conversion completions
nullifiedconversionBooleanSignifies the statisic is nullified
safetyconversionIntegerNumber 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 statistic
defense, 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

Double

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:
AttributeParent ElementTypeDescription
attemptdefense_conversionIntegerNumber of defensive conversion attempts
categorydefense_conversionStringCategory of defensive conversion
conversion, extra_point
completedefense_conversionIntegerNumber of defensive conversion completions
nullifieddefense_conversionBooleanSignifies the statisic is nullified
Down Conversion Play Statistics:
AttributeParent ElementTypeDescription
attemptdown_conversionIntegerNumber of down conversion attempts
completedown_conversionStringCategory of down conversion
conversion, extra_point
downdown_conversionIntegerNumber of the down at play start
categoryfirst_downStringType of first down
pass, rush, penalty
nullifiedfirst_downBooleanSignifies the first down is nullified
nullifieddefense_conversionBooleanSignifies the statisic is nullified
Extra Point Play Statistics:
AttributeParent ElementTypeDescription
attemptextra_pointIntegerNumber of attempted extra points
blockedextra_pointIntegerNumber of blocked extra points
madeextra_pointIntegerNumber of made extra points
missedextra_pointIntegerNumber of missed extra points
nullifiedextra_pointBooleanSignifies the statisic is nullified
returnedextra_pointIntegerNumber of returned extra points
safetyextra_pointIntegerNumber of extra point safeties
Field Goal Play Statistics:
AttributeParent ElementTypeDescription
attemptfield_goalIntegerNumber of attempted field goals
att_yardsfield_goalIntegerYardage of attempted field goal
blockedfield_goalIntegerNumber of blocked field goals
madefield_goalIntegerNumber of made field goals
missedfield_goalIntegerNumber of missed field goals
nullifiedfield_goalBooleanSignifies a nullified field goal attempt
returnedfield_goalIntegerNumber of returned field goals
yardsfield_goalIntegerYardage of made field goal
Fumbles Play Statistics:
AttributeParent ElementTypeDescription
forcedfumbleIntegerNumber of forced fumbles
fumblefumbleIntegerNumber of fumbles
lostfumbleIntegerNumber of lost fumbles
nullifiedfumbleBooleanSignifies a nullified play due to a penalty
opp_recfumbleIntegerNumber of opponent fumble recoveries
opp_rec_tdfumbleIntegerNumber of opponent fumble recovery touchdowns
opp_rec_yardsfumbleIntegerNumber of opponent fumble recovery yards
out_of_boundsfumbleIntegerNumber of fumbles out of bounds
own_recfumbleIntegerNumber of own fumble recoveries
own_rec_tdfumbleIntegerNumber of own fumble recovery touchdowns
own_rec_yardsfumbleIntegerNumber of own fumble recovery yards
play_categoryfumbleStringType of fumble
ex. misc
Kickoff Play Statistics:
AttributeParent ElementTypeDescription
attemptkickIntegerNumber of kickoff attempts
endzonekickIntegerNumber of kicks into the endzone
inside_20kickIntegerNumber of kicks inside the 20 yardline
net_yardskickIntegerNumber of net yards on the kickoff
nullifiedkickBooleanSignifies a nullified play due to a penalty
onside_attemptkickBooleanNumber of onside kickoff attempts
onside_successkickBooleanNumber of onside kickoff successes
own_reckickBooleanNumber of own recoveries on a kickoff
own_rec_tdkickBooleanNumber of own recovery touchdowns on a kickoff
squib_kickkickBooleanNumber of squib kicks
touchbackkickBooleanNumber of touchbacks
yardskickBooleanNumber of kickoff yards
Passing Play Statistics:
AttributeParent ElementTypeDescription
attemptpassIntegerNumber of pass attempts
completepassIntegerNumber of pass completions
firstdownpassIntegerNumber of passing first downs
goaltogopassIntegerNumber of plays in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
inside_20passIntegerNumber of passes inside the 20 yardline
interceptionpassIntegerNumber of interceptions thrown
int_touchdownpassIntegerNumber of interception touchdowns thrown
nullifiedpassBooleanSignifies a nullified play due to a penalty
sackpassIntegerNumber of sacks
sack_yardspassDoubleNumber of sack yards
safetypassIntegerNumber of safeties
touchdownpassIntegerNumber of touchdowns
yardspassIntegerNumber of passing yards
Penalty Play Statistics:
AttributeParent ElementTypeDescription
penaltypenaltyIntegerNumber of penalties
yardspenaltyIntegerNumber of penalty yardage
Punting Play Statistics:
AttributeParent ElementTypeDescription
attemptpuntIntegerNumber of attempted punts
blockedpuntIntegerNumber of blocked punts
endzonepuntIntegerNumber of punts into the endzone
inside_20puntIntegerNumber of punts inside the 20 yardline
net_yardspuntIntegerNet yardage of a punt
nullifiedpuntBooleanSignifies a nullified play due to a penalty
touchbackpuntIntegerNumber of touchback punts
yardspuntIntegerYardage of punt
Receiving Play Statistics:

Attribute

Parent Element

Type

Description

firstdown

receive

Integer

Number of receiving first downs

fumble

receive

Integer

Number of receiving fumbles

goaltogo

receive

Integer

Number of receptions in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)

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

Yards after catch is not currently a collected statistic for NCAA Football

Return Play Statistics:
AttributeParent ElementTypeDescription
categoryreturnStringType of return
punt_return, kick_return
faircatchreturnIntegerNumber of return fair catches
nullifiedreturnBooleanSignifies a nullified play due to a penalty
returnreturnIntegerNumber of returns
touchbackreturnIntegerNumber of return touchbacks
touchdownreturnIntegerNumber of return touchdowns
yardsreturnIntegerNumber of return yardage
Rushing Play Statistics:
AttributeParent ElementTypeDescription
attemptrushIntegerNumber of rushing attempts
firstdownrushIntegerNumber of rushing first downs
fumblerushIntegerNumber of rushing fumbles
goaltogorushIntegerNumber of rushes in a goal-to-go situation (eg. 1st & Goal, 2nd & Goal, etc.)
inside_20rushIntegerNumber of rushes inside the 20 yardline
nullifiedrushBooleanSignifies a nullified play due to a penalty
safetyrushIntegerNumber of rushing safeties
tlostrushIntegerNumber of rushing tackles for a loss
tlost_yardsrushIntegerNumber of rushing tackles for a loss yardage
touchdownrushIntegerNumber of rushing touchdowns
yardsrushIntegerNumber of rushing yards
Player:

Attribute

Parent Element

Type

Description

id

player

GUID

Unique ID of a player
ex. 4be48c57-4b7c-46ad-8535-445c195feda6

jersey

player

String

Jersey number of a player

name

player

String

Full name of a player
ex. Stetson Bennett

position

player

String

Position of a player

See our FAQ for a list of valid positions

role

player

String

Role of a player during a specific play
ex. pass, receive, tackle, rush, defend, catch, ast_tackle, kick, return, penalty

Standings:

Team win-loss-tie data is added after a game moves to complete status. It is not present prior to or during a game.

AttributeParent ElementTypeDescription
lossesrecordIntegerNumber of team losses year-to-date after a game
tiesrecordIntegerNumber of team ties year-to-date after a game
winsrecordIntegerNumber of team wins year-to-date after a game
Team:
AttributeParent ElementTypeDescription
aliasteamStringTeam alias
ex. IOW (University of Iowa)
idteamGUIDUnique ID of a team
ex. a2ee495d-37c7-45ac-ac3d-d3a492a219c1
marketteamStringTeam market name
ex. Iowa
nameteamStringTeam name
ex. Hawkeyes
Venue:
AttributeParent ElementTypeDescription
addressvenueStringAddress of a venue
ex. 886 Stadium Drive
capacityvenueIntegerCapacity of a venue
ex. 69250
cityvenueStringCity of a venue
ex. Iowa City
countryvenueStringCountry of a venue
ex. USA
idvenueGUIDUnique ID of a venue
ex. 967ef86b-d0de-49b7-8984-61f95104d30d
latvenue - locationDecimalLatitude of a venue
ex. 41.6587
lngvenue - locationDecimalLongitude of a venue
ex. -91.5511
namevenueStringName of a venue
ex. Kinnick Stadium
roof_typevenueStringRoof type of a venue
outdoor, dome, retractable_dome
statevenueStringState of a venue
ex. IA
surfacevenueStringSurface type of a venue
turf, artificial, outdoor
zipvenueIntegerZIP code of a venue
ex. 52242
Language
Credentials
Header
Click Try It! to start a request and see the response here!