College Football Data API
​string​integer · int32​integer · int32 · required​string · required​string | null · required​string | null · required​array | null · required​string | null · required​string | null · required​string | null · required​string | null · required​string | null · required​array | null · required​string | null · required
​integer · int32​integer · int32 · required​string · required​string | null · required​string | null · required​array | null · required​string | null · required​string | null · required​string | null · required​string | null · required​string | null · required​array | null · required​string | null · required
​string · required​string · required​integer · int32​integer · int32​string · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32​integer · int32
​integer · int32 · required​string​string​integer · int32 · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required
​string​integer · int32​DivisionClassification · enum​string · required​string · required​string · required​string · required​number | null · double · required​integer | null · int32 · required​integer | null · int32 · required​string | null · required​string | null · required​string | null · required​string | null · required​number | null · double · required​number | null · double · required​string | null · required​array | null · required​integer · int32 · deprecated
​integer · int32 · required​integer · int32 · required​string · required​number · double · required
Teams, rosters, matchups, talent ratings, and ATS records.
GET
https://api.collegefootballdata.com
/teams
Bearer
Returns team information and conference affiliations.
query Parameters
conferenceConference abbreviation.
yearSeason year for historical conference affiliations.
Responses
200
Ok
​Team[]
idschoolmascotabbreviationalternateNamesconferencedivisionclassificationcoloralternateColorlogostwitter​object · required
GET
https://api.collegefootballdata.com
/teams/fbs
Bearer
Returns Football Bowl Subdivision (FBS) teams for a season.
query Parameters
yearSeason year.
Responses
200
Ok
​Team[]
idschoolmascotabbreviationalternateNamesconferencedivisionclassificationcoloralternateColorlogostwitter​object · required
GET
https://api.collegefootballdata.com
/teams/matchup
Bearer
Returns historical matchup results between two teams.
query Parameters
team1First team name.
team2Second team name.
minYearEarliest season year to include.
maxYearLatest season year to include.
Responses
200
Ok
team1team2team1Winsteam2Winsties​MatchupGame[] · required
startYearendYearGET
https://api.collegefootballdata.com
/teams/ats
Bearer
Returns against-the-spread (ATS) records by team.
query Parameters
yearSeason year.
conferenceConference name or abbreviation.
teamTeam name.
Responses
200
Ok
​TeamATS[]
yearteamIdteamconferencegamesatsWinsatsLossesatsPushesavgCoverMarginGET
https://api.collegefootballdata.com
/roster
Bearer
Returns historical roster data.
query Parameters
teamTeam name.
yearSeason year. Defaults to 2025.
classificationDivision classification: fbs or fcs.
Enum values:
fbs
fcs
ii
iii
Responses
200
Ok
idfirstNamelastNameteamheightweightjerseypositionhomeCityhomeStatehomeCountryhomeLatitudehomeLongitudehomeCountyFIPSrecruitIdsyearGET
https://api.collegefootballdata.com
/talent
Bearer
Returns 247Sports Team Talent Composite ratings for a season.
query Parameters
yearSeason year.
Responses
200
Ok
​TeamTalent[]
yearteamtalent