v4

latestOpenAPI 3.0.0MIT2026-07-3171143160.0 KB
plays

Retrieves historical play data

get/plays

Query parameters

yearinteger required

Required year filter

weekinteger required

Required week filter

teamstring

Optional team filter

offensestring

Optional offensive team filter

defensestring

Optional defensive team filter

offenseConferencestring

Optional offensive conference filter

defenseConferencestring

Optional defensive conference filter

conferencestring

Optional conference filter

playTypestring

Optoinal play type abbreviation filter

seasonType'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'

Optional season type filter

classification'fbs' | 'fcs' | 'ii' | 'iii'

Optional division classification filter

Response

Ok

idstring required
driveIdstring required
gameIdinteger required
driveNumberinteger nullable required
playNumberinteger nullable required
offensestring required
offenseConferencestring nullable required
offenseScoreinteger required
defensestring required
homestring required
awaystring required
defenseConferencestring nullable required
defenseScoreinteger required
periodinteger required
offenseTimeoutsinteger nullable required
defenseTimeoutsinteger nullable required
yardlineinteger required
yardsToGoalinteger required
downinteger required
distanceinteger required
yardsGainedinteger required
scoringboolean required
playTypestring required
playTextstring nullable required
ppanumber double nullable required
wallclockstring nullable required