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

Passing

Download schema

Enriched pass attempts and player and team passing production.


GET
https://api.collegefootballdata.com
/passing/plays
Bearer

Returns enriched pass attempts.

query Parameters

year
​integer · int32 · required

Season year.

team
​string

Team name on either side of the pass. Either team or week is required.

week
​integer · int32

Week number. Either team or week is required.

gameId
​integer · int32

Game ID.

seasonType
​SeasonType · enum

Season type.

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

Offensive team name.

defense
​string

Defensive team name.

conference
​string

Conference name or abbreviation on either side of the pass.

passerId
​string

Passer athlete ID.

targetId
​string

Intended target athlete ID.

outcome
​PassOutcome · enum

Pass outcome.

Enum values:
completion
incompletion
interception
classification
​DivisionClassification · enum

Division classification. Defaults to fbs.

Enum values:
fbs
fcs
ii
ii/iii
iii

Responses

200

Ok

​PassingPlay[]
PassingPlay
gameId
​integer · int32 · required
playId
​string · required
driveId
​string · required
season
​integer · int32 · required
week
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
offenseId
​integer · int32 · required
offense
​string · required
offenseConference
​string | null · required
defenseId
​integer · int32 · required
defense
​string · required
defenseConference
​string | null · required
period
​integer · int32 · required
​PassingPlayClock · required
down
​integer · int32 · required
distance
​integer · int32 · required
playText
​string | null · required
passerId
​string | null · required
passer
​string | null · required
targetId
​string | null · required
target
​string | null · required
outcome
​PassOutcome · enum · required
Enum values:
completion
incompletion
interception
airYards
​integer | null · int32 · required
passDepth
​string · enum · required
Enum values:
short
deep
passDirection
​string · enum · required
Enum values:
left
middle
right
passLocation
​string · enum · required
Enum values:
short left
short middle
short right
deep left
deep middle
deep right
totalYards
​integer | null · int32 · required
yardsAfterCatch
​integer | null · int32 · required
startYardline
​integer · int32 · required
startYardsToGoal
​integer · int32 · required
targetYardsToGoal
​integer | null · int32 · required
isSpike
​boolean · required
isThrowaway
​boolean · required
isIntentionalGrounding
​boolean · required
parseStatus
​PassParseStatus · enum · required
Enum values:
complete
partial
invalid
GET/passing/plays
curl 'https://api.collegefootballdata.com/passing/plays?year=<number>' \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "gameId": 0, "playId": "playId", "driveId": "driveId", "season": 0, "week": 0, "seasonType": "regular", "offenseId": 0, "offense": "offense", "offenseConference": "offenseConference", "defenseId": 0, "defense": "defense", "defenseConference": "defenseConference", "period": 0, "clock": { "minutes": 0, "seconds": 0 }, "down": 0, "distance": 0, "playText": "playText", "passerId": "passerId", "passer": "passer", "targetId": "targetId", "target": "target", "outcome": "completion", "airYards": 0, "passDepth": "short", "passDirection": "left", "passLocation": "short left", "totalYards": 0, "yardsAfterCatch": 0, "startYardline": 0, "startYardsToGoal": 0, "targetYardsToGoal": 0, "isSpike": true, "isThrowaway": true, "isIntentionalGrounding": true, "parseStatus": "complete" } ]
json
application/json

GET
https://api.collegefootballdata.com
/passing/players/season
Bearer

Returns passer production by season.

query Parameters

year
​integer · int32

Season year. Required unless passerId is specified.

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.

passerId
​string

Passer athlete ID. Required unless year is specified.

classification
​DivisionClassification · enum

Division classification. Defaults to fbs.

Enum values:
fbs
fcs
ii
ii/iii
iii

Responses

200

Ok

​PlayerPassingSeason[]
PlayerPassingSeason
attempts
​integer · int32 · required
completions
​integer · int32 · required
incompletions
​integer · int32 · required
interceptions
​integer · int32 · required
completionRate
​number | null · double · required
airYardsAttemptsAvailable
​integer · int32 · required

Number of attempts with non-null air yards, including zero-yard values.

totalAirYards
​integer | null · int32 · required
averageDepthOfTarget
​number | null · double · required
totalYardsAttemptsAvailable
​integer · int32 · required

Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.

totalYards
​integer | null · int32 · required
yardsAfterCatchAttemptsAvailable
​integer · int32 · required

Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.

totalYardsAfterCatch
​integer | null · int32 · required
averageYardsAfterCatch
​number | null · double · required
season
​integer · int32 · required
playerId
​string · required
player
​string · required
team
​string · required
conference
​string | null · required
GET/passing/players/season
curl https://api.collegefootballdata.com/passing/players/season \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "attempts": 0, "completions": 0, "incompletions": 0, "interceptions": 0, "completionRate": 0, "airYardsAttemptsAvailable": 0, "totalAirYards": 0, "averageDepthOfTarget": 0, "totalYardsAttemptsAvailable": 0, "totalYards": 0, "yardsAfterCatchAttemptsAvailable": 0, "totalYardsAfterCatch": 0, "averageYardsAfterCatch": 0, "season": 0, "playerId": "playerId", "player": "player", "team": "team", "conference": "conference" } ]
json
application/json

GET
https://api.collegefootballdata.com
/passing/players/games
Bearer

Returns passer production by game.

query Parameters

year
​integer · int32 · required

Season year. Required.

week
​integer · int32

Week number. Either passerId, team, or week is required.

seasonType
​SeasonType · enum

Season type.

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

Team name. Either passerId, team, or week is required.

conference
​string

Conference name or abbreviation.

passerId
​string

Passer athlete ID. Either passerId, team, or week is required.

classification
​DivisionClassification · enum

Division classification. Defaults to fbs.

Enum values:
fbs
fcs
ii
ii/iii
iii

Responses

200

Ok

​PlayerPassingGame[]
PlayerPassingGame
attempts
​integer · int32 · required
completions
​integer · int32 · required
incompletions
​integer · int32 · required
interceptions
​integer · int32 · required
completionRate
​number | null · double · required
airYardsAttemptsAvailable
​integer · int32 · required

Number of attempts with non-null air yards, including zero-yard values.

totalAirYards
​integer | null · int32 · required
averageDepthOfTarget
​number | null · double · required
totalYardsAttemptsAvailable
​integer · int32 · required

Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.

totalYards
​integer | null · int32 · required
yardsAfterCatchAttemptsAvailable
​integer · int32 · required

Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.

totalYardsAfterCatch
​integer | null · int32 · required
averageYardsAfterCatch
​number | null · double · required
gameId
​integer · int32 · required
season
​integer · int32 · required
week
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
playerId
​string · required
player
​string · required
team
​string · required
conference
​string | null · required
opponent
​string · required
GET/passing/players/games
curl 'https://api.collegefootballdata.com/passing/players/games?year=<number>' \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "attempts": 0, "completions": 0, "incompletions": 0, "interceptions": 0, "completionRate": 0, "airYardsAttemptsAvailable": 0, "totalAirYards": 0, "averageDepthOfTarget": 0, "totalYardsAttemptsAvailable": 0, "totalYards": 0, "yardsAfterCatchAttemptsAvailable": 0, "totalYardsAfterCatch": 0, "averageYardsAfterCatch": 0, "gameId": 0, "season": 0, "week": 0, "seasonType": "regular", "playerId": "playerId", "player": "player", "team": "team", "conference": "conference", "opponent": "opponent" } ]
json
application/json

GET
https://api.collegefootballdata.com
/passing/teams/season
Bearer

Returns team passing production by season.

query Parameters

year
​integer · int32

Season year. Required unless team is specified.

seasonType
​SeasonType · enum

Season type.

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

Team name. Required unless year is specified.

conference
​string

Conference name or abbreviation.

classification
​DivisionClassification · enum

Division classification. Defaults to fbs.

Enum values:
fbs
fcs
ii
ii/iii
iii

Responses

200

Ok

​TeamPassingSeason[]
TeamPassingSeason
season
​integer · int32 · required
team
​string · required
conference
​string | null · required
​PassingProduction · required
​PassingProduction · required
GET/passing/teams/season
curl https://api.collegefootballdata.com/passing/teams/season \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "season": 0, "team": "team", "conference": "conference", "offense": { "attempts": 0, "completions": 0, "incompletions": 0, "interceptions": 0, "completionRate": 0, "airYardsAttemptsAvailable": 0, "totalAirYards": 0, "averageDepthOfTarget": 0, "totalYardsAttemptsAvailable": 0, "totalYards": 0, "yardsAfterCatchAttemptsAvailable": 0, "totalYardsAfterCatch": 0, "averageYardsAfterCatch": 0 }, "defense": { "attempts": 0, "completions": 0, "incompletions": 0, "interceptions": 0, "completionRate": 0, "airYardsAttemptsAvailable": 0, "totalAirYards": 0, "averageDepthOfTarget": 0, "totalYardsAttemptsAvailable": 0, "totalYards": 0, "yardsAfterCatchAttemptsAvailable": 0, "totalYardsAfterCatch": 0, "averageYardsAfterCatch": 0 } } ]
json
application/json

GET
https://api.collegefootballdata.com
/passing/teams/games
Bearer

Returns team passing production by game.

query Parameters

year
​integer · int32 · required

Season year. Required.

week
​integer · int32

Week number. Either team or week is required.

seasonType
​SeasonType · enum

Season type.

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

Team name. Either team or week is required.

conference
​string

Conference name or abbreviation.

classification
​DivisionClassification · enum

Division classification. Defaults to fbs.

Enum values:
fbs
fcs
ii
ii/iii
iii

Responses

200

Ok

​TeamPassingGame[]
TeamPassingGame
gameId
​integer · int32 · required
season
​integer · int32 · required
week
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
team
​string · required
conference
​string | null · required
opponent
​string · required
​PassingProduction · required
​PassingProduction · required
GET/passing/teams/games
curl 'https://api.collegefootballdata.com/passing/teams/games?year=<number>' \ --header 'Authorization: Bearer <token>'
Example Responses
[ { "gameId": 0, "season": 0, "week": 0, "seasonType": "regular", "team": "team", "conference": "conference", "opponent": "opponent", "offense": { "attempts": 0, "completions": 0, "incompletions": 0, "interceptions": 0, "completionRate": 0, "airYardsAttemptsAvailable": 0, "totalAirYards": 0, "averageDepthOfTarget": 0, "totalYardsAttemptsAvailable": 0, "totalYards": 0, "yardsAfterCatchAttemptsAvailable": 0, "totalYardsAfterCatch": 0, "averageYardsAfterCatch": 0 }, "defense": { "attempts": 0, "completions": 0, "incompletions": 0, "interceptions": 0, "completionRate": 0, "airYardsAttemptsAvailable": 0, "totalAirYards": 0, "averageDepthOfTarget": 0, "totalYardsAttemptsAvailable": 0, "totalYards": 0, "yardsAfterCatchAttemptsAvailable": 0, "totalYardsAfterCatch": 0, "averageYardsAfterCatch": 0 } } ]
json
application/json

PlaysTeams