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
Passing
    /passing/playsget/passing/players/seasonget/passing/players/gamesget/passing/teams/seasonget/passing/teams/gamesget
Rushing
    /rushing/playsget/rushing/players/seasonget/rushing/players/gamesget/rushing/teams/seasonget/rushing/teams/gamesget
Teams
    /teamsget/teams/fbsget/teams/matchupget/teams/atsget/rosterget/talentget
Conferences
    /conferencesget/conferences/changesget/conferences/affiliationsget
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
Adjusted metrics
    /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

Drives

Download schema

Historical drive-level data.


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

Returns historical drive data.

query Parameters

year
​integer · int32 · required

Season year.

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 drive.

offense
​string

Offensive team name.

defense
​string

Defensive team name.

conference
​string

Conference of either team.

offenseConference
​string

Offensive team conference.

defenseConference
​string

Defensive team conference.

classification
​DivisionClassification · enum

Division classification of either team.

Enum values:
fbs
fcs
ii
ii/iii
iii

Responses

200

Ok

​Drive[]
Drive
offense
​string · required
offenseConference
​string | null · required
defense
​string · required
defenseConference
​string | null · required
gameId
​integer · int32 · required
id
​string · required
driveNumber
​integer | null · int32 · required
scoring
​boolean · required
startPeriod
​integer · int32 · required
startYardline
​integer · int32 · required
startYardsToGoal
​integer · int32 · required
​object · required
endPeriod
​integer · int32 · required
endYardline
​integer · int32 · required
endYardsToGoal
​integer · int32 · required
​object · required
​object · required
plays
​integer · int32 · required
yards
​integer · int32 · required
driveResult
​string · required
isHomeOffense
​boolean · required
startOffenseScore
​integer · int32 · required
startDefenseScore
​integer · int32 · required
endOffenseScore
​integer · int32 · required
endDefenseScore
​integer · int32 · required
GET/drives
curl 'https://api.collegefootballdata.com/drives?year=<number>' \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "offense": "offense", "offenseConference": "offenseConference", "defense": "defense", "defenseConference": "defenseConference", "gameId": 0, "id": "id", "driveNumber": 0, "scoring": true, "startPeriod": 0, "startYardline": 0, "startYardsToGoal": 0, "startTime": { "seconds": 0, "minutes": 0 }, "endPeriod": 0, "endYardline": 0, "endYardsToGoal": 0, "endTime": { "seconds": 0, "minutes": 0 }, "elapsed": { "seconds": 0, "minutes": 0 }, "plays": 0, "yards": 0, "driveResult": "driveResult", "isHomeOffense": true, "startOffenseScore": 0, "startDefenseScore": 0, "endOffenseScore": 0, "endDefenseScore": 0 } ]
json
application/json

PlayoffsPlays