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

betting

Download schema

Historical betting lines and results.


GET
https://api.collegefootballdata.com
/lines
Bearer

Returns historical betting lines and results.

query Parameters

gameId
​integer · int32

Game ID.

year
​integer · int32

Season year. Required unless gameId is specified.

seasonType
​SeasonType · enum

Season type.

Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
week
​integer · int32

Week number.

team
​string

Team name on either side of the game.

home
​string

Home team name.

away
​string

Away team name.

conference
​string

Conference of either team.

provider
​string

Betting line provider.

Responses

200

Ok

​BettingGame[]
BettingGame
id
​integer · int32 · required
season
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
week
​integer · int32 · required
startDate
​string · date-time · required
homeTeamId
​integer · int32 · required
homeTeam
​string · required
homeConference
​string | null · required
homeClassification
​string · enum · required
Enum values:
fbs
fcs
ii
iii
homeScore
​integer | null · int32 · required
awayTeamId
​integer · int32 · required
awayTeam
​string · required
awayConference
​string | null · required
awayClassification
​string · enum · required
Enum values:
fbs
fcs
ii
iii
awayScore
​integer | null · int32 · required
​GameLine[] · required
GET/lines
curl https://api.collegefootballdata.com/lines \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "id": 0, "season": 0, "seasonType": "regular", "week": 0, "startDate": "2024-08-25T15:00:00Z", "homeTeamId": 0, "homeTeam": "homeTeam", "homeConference": "homeConference", "homeClassification": "fbs", "homeScore": 0, "awayTeamId": 0, "awayTeam": "awayTeam", "awayConference": "awayConference", "awayClassification": "fbs", "awayScore": 0, "lines": [ { "provider": "provider", "spread": 0, "formattedSpread": "formattedSpread", "spreadOpen": 0, "overUnder": 0, "overUnderOpen": 0, "homeMoneyline": 0, "awayMoneyline": 0 } ] } ]
json
application/json

rankingsrecruiting