College Football Data API
​string​string​string​integer · int32​integer · int32​integer · int32​integer · int32 · required​string · required​string · required​string | null · date-time · deprecated
​integer · int32 · required​integer · int32 · required​string · required​string · required​string | null · required​string | null · required​integer | null · int32 · required​string | null · required​integer | null · int32 · required
​integer · int32​string​integer · int32​integer · int32​integer · int32​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​integer · int32 · required​integer | null · int32 · required​integer | null · int32 · required​number | null · double · required​number | null · double · required​number | null · double · required​number | null · double · required​boolean · required
​integer · int32​string​integer · int32​boolean​integer · int32 · required​string | null · required​integer · int32 · required​integer | null · int32 · required​string | null · date-time · required​string | null · date-time · required​boolean · required​boolean · required​integer · int32 · required​boolean · required
coaches
Head coach identities, careers, seasons, and tenures.
GET
https://api.collegefootballdata.com
/coaches
Bearer
Returns historical head coach records.
query Parameters
firstNameCoach first name.
lastNameCoach last name.
teamTeam name.
yearSeason year.
minYearEarliest season year to include.
maxYearLatest season year to include.
Responses
200
Ok
​Coach[]
idfirstNamelastName​CoachSeason[] · required
hireDateGET
https://api.collegefootballdata.com
/coaches/profile
Bearer
Returns a coach profile with canonical identity and career totals.
query Parameters
coachIdCoach ID.
Responses
Ok
idfirstNamelastNamedisplayName​object · required
​CoachCareer · required
birthDate​object · required
graduationYearwikidataIdhallOfFameYearGET
https://api.collegefootballdata.com
/coaches/seasons
Bearer
Returns coach-season records with attributed results and team context.
query Parameters
coachIdCoach ID.
teamTeam name.
yearExact season year.
minYearEarliest season year to include.
maxYearLatest season year to include.
Responses
Ok
gameswinslossestieswinPercentage​CoachReference · required
​CoachSeasonTeamReference · required
yearpreseasonRankpostseasonRanksrsspOverallspOffensespDefense​CoachRatingContext · required
​CoachRecruitingContext · required
​object · required
attributionComplete​object · required
​object · required
​CoachCfpContext · required
​object · required
GET
https://api.collegefootballdata.com
/coaches/tenures
Bearer
Returns continuous head-coaching tenures and their attributed records.
query Parameters
coachIdCoach ID.
teamTeam name.
yearSeason year contained within the tenure.
activeFilters by active status when specified.
Responses
Ok
id​CoachReference · required
​CoachTeamReference · required
hireDatestartYearendYeareffectiveStarteffectiveEndisInterimactiveseasons​CoachRecord · required
attributionComplete