College Football Data API
​integer · int32 · required​integer · int32 · required​string​string​string​string​string​string​string​SeasonType · enum​DivisionClassification · enum​string · required​string · required​integer · int32 · required​integer | null · int32 · required​integer | null · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer | null · int32 · required​integer | null · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​boolean · required​string · required​string | null · required​number | null · double · required​string | null · required
​integer · int32 · required​string · required​string | null · required
​integer · int32​integer · int32​string​integer · int32​integer · int32​integer · int32​SeasonType · enum​string​number · double · required​number · double · required​number · double · required​string · required​string · required​string · required​number · double · required​number · double · required​string · required​string · required​number · double · required​number · double · required​number · double · required​number · double · required​string · required​string · required​string · required​number · double · required
​integer · int32 · required​integer · int32 · required​string · required​integer | null · int32 · required​string · required​string · required​integer | null · int32 · required​integer | null · int32 · required​integer | null · int32 · required
Historical and live play-by-play data.
GET
https://api.collegefootballdata.com
/plays
Bearer
Returns historical play-by-play data.
query Parameters
yearSeason year.
weekWeek number.
teamTeam name on either side of the play.
offenseOffensive team name.
defenseDefensive team name.
offenseConferenceOffensive team conference.
defenseConferenceDefensive team conference.
conferenceConference of either team.
playTypePlay type abbreviation.
seasonTypeSeason type.
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
classificationDivision classification of either team.
Enum values:
fbs
fcs
ii
iii
Responses
200
Ok
​Play[]
iddriveIdgameIddriveNumberplayNumberoffenseoffenseConferenceoffenseScoredefensehomeawaydefenseConferencedefenseScoreperiod​object · required
offenseTimeoutsdefenseTimeoutsyardlineyardsToGoaldowndistanceyardsGainedscoringplayTypeplayTextppawallclockGET
https://api.collegefootballdata.com
/plays/types
Bearer
Returns the available play types.
Responses
200
Ok
​PlayType[]
idtextabbreviationGET
https://api.collegefootballdata.com
/plays/stats
Bearer
Returns player and play-stat associations, limited to 2,000 records.
query Parameters
yearSeason year.
weekWeek number.
teamTeam name.
gameIdGame ID.
athleteIdAthlete ID.
statTypeIdPlay stat type ID.
seasonTypeSeason type.
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
conferenceConference name or abbreviation.
Responses
200
Ok
​PlayStat[]
gameIdseasonweekteamconferenceopponentteamScoreopponentScoredriveIdplayIdperiod​object · required
yardsToGoaldowndistanceathleteIdathleteNamestatTypestatGET
https://api.collegefootballdata.com
/live/plays
Bearer
Returns live play-by-play data and advanced metrics for a game.
query Parameters
gameIdGame ID.
Responses
200
Ok
idstatusperiodclockpossessiondowndistanceyardsToGoal​LiveGameTeam[] · required
​LiveGameDrive[] · required