College Football DataCollege Football Data
  • CollegeFootballData.com
  • Get API Key
  • Legacy Swagger UI
  • Getting Started
  • Official libraries
  • Methodology and resources
  • API Reference
Helpful Links
  • CFBD
  • Patreon
  • Gumroad
Data + Code Packs
  • Starter Pack
  • Model Training Pack
  • AI Launchpad
  • AI Builder Pack
Other Resources
  • Rad Sports Analytics
  • Blog
  • Basketball

A Rad Sports Analytics platform.

xdiscordgithub
Information
games
    /gamesget/games/teamsget/games/playersget/games/mediaget/games/weatherget/recordsget/calendarget/scoreboardget/game/box/advancedget
playoffs
    /playoffs/cfpget/playoffs/cfp/participantsget/playoffs/cfp/gamesget
drives
    /drivesget
plays
    /playsget/plays/typesget/plays/statsget/plays/stats/typesget/live/playsget
teams
    /teamsget/teams/fbsget/teams/matchupget/teams/atsget/rosterget/talentget
conferences
    /conferencesget
venues
    /venuesget
coaches
    /coachesget/coaches/profileget/coaches/seasonsget/coaches/tenuresget
players
    /player/searchget/player/usageget/player/season/overviewget/player/returningget/player/portalget
rankings
    /rankingsget
betting
    /linesget
recruiting
    /recruiting/playersget/recruiting/teamsget/recruiting/groupsget
ratings
    /ratings/coreget/ratings/spget/ratings/sp/conferencesget/ratings/srsget/ratings/srs/expandedget/ratings/eloget/ratings/fpiget
metrics
    /ppa/predictedget/ppa/teamsget/ppa/gamesget/ppa/players/gamesget/ppa/players/seasonget/metrics/wpget/metrics/wp/pregameget/metrics/fg/epget
stats
    /stats/player/seasonget/stats/player/successget/stats/player/success/gameget/stats/seasonget/stats/categoriesget/stats/season/advancedget/stats/game/advancedget/stats/game/havocget
draft
    /draft/teamsget/draft/positionsget/draft/picksget
adjustedMetrics
    /wepa/team/seasonget/wepa/players/passingget/wepa/players/rushingget/wepa/players/kickingget
info
    /infoget/info/usageget
Schemas
powered by Zudoku
College Football Data API
College Football Data API

ratings

Download schema

SP+, SRS, Elo, FPI, and CORE team ratings.


GET
https://api.collegefootballdata.com
/ratings/core
Bearer

Returns Context & Opponent-Relative Efficiency (CORE) ratings. At least one of year or team is required.

query Parameters

year
​integer · int32

Season year. Required unless team is specified.

team
​string

Exact team name. Required unless year is specified.

conference
​string

Conference name or abbreviation.

Responses

200

Ok

​TeamCoreRating[]
TeamCoreRating
year
​integer · int32 · required
throughSeasonType
​CoreRatingSeasonType · enum · required
Enum values:
regular
postseason
throughWeek
​integer · int32 · required
team
​string · required
conference
​string | null · required
overall
​number · double · required

Offense-minus-defense composite; higher is better.

offense
​number · double · required

Points created above average per 100 qualifying plays; higher is better.

defense
​number · double · required

Points allowed above average per 100 qualifying plays; lower is better.

offensePlays
​integer · int32 · required
defensePlays
​integer · int32 · required
modelVersion
​string · required
GET/ratings/core
curl https://api.collegefootballdata.com/ratings/core \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "throughSeasonType": "regular", "throughWeek": 0, "team": "team", "conference": "conference", "overall": 0, "offense": 0, "defense": 0, "offensePlays": 0, "defensePlays": 0, "modelVersion": "modelVersion" } ]
json
application/json

GET
https://api.collegefootballdata.com
/ratings/sp
Bearer

Returns SP+ ratings by team and season.

query Parameters

year
​integer · int32

Season year. Required unless team is specified.

team
​string

Team name. Required unless year is specified.

Responses

200

Ok

​TeamSP[]
TeamSP
year
​integer · int32 · required
team
​string · required
conference
​string | null · required
rating
​number · double · required
ranking
​integer | null · int32 · required
secondOrderWins
​number | null · double · required
sos
​number | null · double · required
​object · required
​object · required
​object · required
GET/ratings/sp
curl https://api.collegefootballdata.com/ratings/sp \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "team": "team", "conference": "conference", "rating": 0, "ranking": 0, "secondOrderWins": 0, "sos": 0, "offense": { "pace": 0, "runRate": 0, "passingDowns": 0, "standardDowns": 0, "passing": 0, "rushing": 0, "explosiveness": 0, "success": 0, "rating": 0, "ranking": 0 }, "defense": { "havoc": { "db": 0, "frontSeven": 0, "total": 0 }, "passingDowns": 0, "standardDowns": 0, "passing": 0, "rushing": 0, "explosiveness": 0, "success": 0, "rating": 0, "ranking": 0 }, "specialTeams": { "rating": 0 } } ]
json
application/json

GET
https://api.collegefootballdata.com
/ratings/sp/conferences
Bearer

Returns conference-level SP+ ratings by season.

query Parameters

year
​integer · int32

Season year.

conference
​string

Conference name or abbreviation.

classification
​DivisionClassification · enum

Division classification. Defaults to fbs.

Enum values:
fbs
fcs
ii
iii

Responses

200

Ok

​ConferenceSP[]
ConferenceSP
year
​integer · int32 · required
conference
​string · required
rating
​number · double · required
secondOrderWins
​number | null · double · required
sos
​number | null · double · required
​object · required
​object · required
​object · required
GET/ratings/sp/conferences
curl https://api.collegefootballdata.com/ratings/sp/conferences \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "conference": "conference", "rating": 0, "secondOrderWins": 0, "sos": 0, "offense": { "pace": 0, "runRate": 0, "passingDowns": 0, "standardDowns": 0, "passing": 0, "rushing": 0, "explosiveness": 0, "success": 0, "rating": 0 }, "defense": { "havoc": { "db": 0, "frontSeven": 0, "total": 0 }, "passingDowns": 0, "standardDowns": 0, "passing": 0, "rushing": 0, "explosiveness": 0, "success": 0, "rating": 0 }, "specialTeams": { "rating": 0 } } ]
json
application/json

GET
https://api.collegefootballdata.com
/ratings/srs
Bearer

Returns Simple Rating System (SRS) ratings by team and season.

query Parameters

year
​integer · int32

Season year. Required unless team is specified.

team
​string

Team name. Required unless year is specified.

conference
​string

Conference name or abbreviation.

Responses

200

Ok

​TeamSRS[]
TeamSRS
year
​integer · int32 · required
team
​string · required
conference
​string | null · required
division
​string | null · required
rating
​number · double · required
ranking
​integer | null · int32 · required
GET/ratings/srs
curl https://api.collegefootballdata.com/ratings/srs \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "team": "team", "conference": "conference", "division": "division", "rating": 0, "ranking": 0 } ]
json
application/json

GET
https://api.collegefootballdata.com
/ratings/srs/expanded
Bearer

Returns expanded Simple Rating System (SRS) ratings, including FCS teams.

query Parameters

year
​integer · int32

Season year. Required unless team is specified.

team
​string

Team name. Required unless year is specified.

conference
​string

Conference name or abbreviation.

classification
​DivisionClassification · enum

Division classification: fbs or fcs.

Enum values:
fbs
fcs
ii
iii

Responses

200

Ok

​ExpandedTeamSRS[]
ExpandedTeamSRS
year
​integer · int32 · required
team
​string · required
conference
​string | null · required
division
​string | null · required
rating
​number · double · required
ranking
​integer | null · int32 · required
classification
​DivisionClassification · enum · required
Enum values:
fbs
fcs
ii
iii
GET/ratings/srs/expanded
curl https://api.collegefootballdata.com/ratings/srs/expanded \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "team": "team", "conference": "conference", "division": "division", "rating": 0, "ranking": 0, "classification": "fbs" } ]
json
application/json

GET
https://api.collegefootballdata.com
/ratings/elo
Bearer

Returns historical Elo ratings.

query Parameters

year
​integer · int32

Season year.

week
​integer · int32

Week number. Defaults to the latest available week in the season.

seasonType
​SeasonType · enum

Season type.

Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
team
​string

Team name.

conference
​string

Conference name or abbreviation.

Responses

200

Ok

​TeamElo[]
TeamElo
year
​integer · int32 · required
team
​string · required
conference
​string · required
elo
​integer | null · int32 · required
GET/ratings/elo
curl https://api.collegefootballdata.com/ratings/elo \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "team": "team", "conference": "conference", "elo": 0 } ]
json
application/json

GET
https://api.collegefootballdata.com
/ratings/fpi
Bearer

Returns historical Football Power Index (FPI) ratings.

query Parameters

year
​integer · int32

Season year. Required unless team is specified.

team
​string

Team name. Required unless year is specified.

conference
​string

Conference name or abbreviation.

Responses

200

Ok

​TeamFPI[]
TeamFPI
year
​integer · int32 · required
team
​string · required
conference
​string | null · required
fpi
​number | null · double · required
​object · required
​object · required
GET/ratings/fpi
curl https://api.collegefootballdata.com/ratings/fpi \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "year": 0, "team": "team", "conference": "conference", "fpi": 0, "resumeRanks": { "gameControl": 0, "remainingStrengthOfSchedule": 0, "strengthOfSchedule": 0, "averageWinProbability": 0, "fpi": 0, "strengthOfRecord": 0 }, "efficiencies": { "specialTeams": 0, "defense": 0, "offense": 0, "overall": 0 } } ]
json
application/json

recruitingmetrics