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

Schemas

Download schema

AdjustedTeamMetrics

year
​integer · int32 · required
teamId
​integer · int32 · required
team
​string · required
conference
​string · required
​object · required
​object · required
​object · required
​object · required
​object · required
​object · required
explosiveness
​number · double · required
explosivenessAllowed
​number · double · required

PlayerWeightedEPA

year
​integer · int32 · required
athleteId
​string · required
athleteName
​string · required
position
​string · required
team
​string · required
conference
​string · required
wepa
​number · double · required
plays
​integer · int32 · required

KickerPAAR

year
​integer · int32 · required
athleteId
​string · required
athleteName
​string · required
team
​string · required
conference
​string · required
paar
​number · double · required
attempts
​integer · int32 · required

Venue

id
​integer | null · int32 · required
name
​string | null · required
city
​string | null · required
state
​string | null · required
zip
​string | null · required
countryCode
​string | null · required
timezone
​string | null · required
latitude
​number | null · double · required
longitude
​number | null · double · required
elevation
​string | null · required
capacity
​integer | null · int32 · required
constructionYear
​integer | null · int32 · required
grass
​boolean | null
dome
​boolean | null

Team

id
​integer · int32 · required
school
​string · required
mascot
​string | null · required
abbreviation
​string | null · required
alternateNames
​array | null · required
conference
​string | null · required
division
​string | null · required
classification
​string | null · required
color
​string | null · required
alternateColor
​string | null · required
logos
​array | null · required
twitter
​string | null · required
​object · required

MatchupGame

season
​integer · int32 · required
week
​integer · int32 · required
seasonType
​string · required
date
​string · required
neutralSite
​boolean · required
venue
​string | null · required
homeTeam
​string · required
homeScore
​integer | null · int32 · required
awayTeam
​string · required
awayScore
​integer | null · int32 · required
winner
​string | null · required

Matchup

team1
​string · required
team2
​string · required
team1Wins
​integer · int32 · required
team2Wins
​integer · int32 · required
ties
​integer · int32 · required
​MatchupGame[] · required
startYear
​integer · int32
endYear
​integer · int32

TeamATS

year
​integer · int32 · required
teamId
​integer · int32 · required
team
​string · required
conference
​string | null · required
games
​integer · int32 · required
atsWins
​integer · int32 · required
atsLosses
​integer · int32 · required
atsPushes
​integer · int32 · required
avgCoverMargin
​number | null · double · required

RosterPlayer

id
​string · required
firstName
​string · required
lastName
​string · required
team
​string · required
height
​number | null · double · required
weight
​integer | null · int32 · required
jersey
​integer | null · int32 · required
position
​string | null · required
homeCity
​string | null · required
homeState
​string | null · required
homeCountry
​string | null · required
homeLatitude
​number | null · double · required
homeLongitude
​number | null · double · required
homeCountyFIPS
​string | null · required
recruitIds
​array | null · required
year
​integer · int32 · deprecated

DivisionClassification

string · enum
Enum values:
fbs
fcs
ii
iii

Conference

id
​integer · int32 · required
name
​string · required
shortName
​string | null · required
abbreviation
​string | null · required
classification
​string · enum · required
Enum values:
fbs
fcs
ii
iii

TeamTalent

year
​integer · int32 · required
team
​string · required
talent
​number · double · required

PlayerStat

season
​integer · int32 · required
playerId
​string · required
player
​string · required
position
​string · required
team
​string · required
conference
​string · required
category
​string · required
statType
​string · required
stat
​string · required

SeasonType

string · enum
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason

PlayerSuccessRateSplit

plays
​integer · int32 · required
successes
​integer · int32 · required
successRate
​number | null · double · required

PlayerSeasonSuccessRate

season
​integer · int32 · required
id
​string · required
name
​string · required
position
​string · required
team
​string · required
conference
​string · required
​PlayerSuccessRateSplit · required
​PlayerSuccessRateSplit · required

SeasonTypeDB

string · enum
Enum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular

PlayerGameSuccessRate

season
​integer · int32 · required
seasonType
​SeasonTypeDB · enum · required
Enum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
week
​integer · int32 · required
gameId
​integer · int32 · required
id
​string · required
name
​string · required
position
​string · required
team
​string · required
conference
​string · required
opponent
​string · required
​PlayerSuccessRateSplit · required
​PlayerSuccessRateSplit · required

TeamStat

season
​integer · int32 · required
team
​string · required
conference
​string · required
statName
​string · required
​required

AdvancedSeasonStat

season
​integer · int32 · required
team
​string · required
conference
​string · required
​object · required
​object · required

AdvancedGameStat

gameId
​integer · int32 · required
season
​integer · int32 · required
seasonType
​SeasonTypeDB · enum · required
Enum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
week
​integer · int32 · required
team
​string · required
opponent
​string · required
​object · required
​object · required

GameHavocStats

gameId
​integer · int32 · required
season
​integer · int32 · required
seasonType
​SeasonTypeDB · enum · required
Enum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
week
​integer · int32 · required
team
​string · required
conference
​string | null · required
opponent
​string · required
opponentConference
​string | null · required
​object · required
​object · required

RecruitClassification

string · enum
Enum values:
JUCO
PrepSchool
HighSchool

Recruit

id
​string · required
athleteId
​string | null · required
recruitType
​RecruitClassification · enum · required
Enum values:
JUCO
PrepSchool
HighSchool
year
​integer · int32 · required
ranking
​integer | null · int32 · required
name
​string · required
school
​string | null · required
committedTo
​string | null · required
position
​string | null · required
height
​number | null · double · required
weight
​integer | null · int32 · required
stars
​integer | null · int32 · required
rating
​number | null · double · required
city
​string | null · required
stateProvince
​string | null · required
country
​string | null · required
​object · required

TeamRecruitingRanking

year
​integer · int32 · required
rank
​integer · int32 · required
team
​string · required
points
​number · double · required

AggregatedTeamRecruiting

team
​string · required
conference
​string · required
positionGroup
​string | null · required
averageRating
​number · double · required
totalRating
​number · double · required
commits
​integer · int32 · required
averageStars
​number · double · required

CoreRatingSeasonType

string · enum
Enum values:
regular
postseason

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

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

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

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

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

TeamElo

year
​integer · int32 · required
team
​string · required
conference
​string · required
elo
​integer | null · int32 · required

TeamFPI

year
​integer · int32 · required
team
​string · required
conference
​string | null · required
fpi
​number | null · double · required
​object · required
​object · required

PollRank

rank
​integer | null · int32 · required
teamId
​integer · int32 · required
school
​string · required
conference
​string | null · required
firstPlaceVotes
​integer | null · int32 · required
points
​integer | null · int32 · required

Poll

poll
​string · required
isFinal
​boolean | null · required
​PollRank[] · required

PollWeek

season
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
week
​integer · int32 · required
​Poll[] · required

RankingPoll

string · enum
Enum values:
cfp

Play

id
​string · required
driveId
​string · required
gameId
​integer · int32 · required
driveNumber
​integer | null · int32 · required
playNumber
​integer | null · int32 · required
offense
​string · required
offenseConference
​string | null · required
offenseScore
​integer · int32 · required
defense
​string · required
home
​string · required
away
​string · required
defenseConference
​string | null · required
defenseScore
​integer · int32 · required
period
​integer · int32 · required
​object · required
offenseTimeouts
​integer | null · int32 · required
defenseTimeouts
​integer | null · int32 · required
yardline
​integer · int32 · required
yardsToGoal
​integer · int32 · required
down
​integer · int32 · required
distance
​integer · int32 · required
yardsGained
​integer · int32 · required
scoring
​boolean · required
playType
​string · required
playText
​string | null · required
ppa
​number | null · double · required
wallclock
​string | null · required

PlayType

id
​integer · int32 · required
text
​string · required
abbreviation
​string | null · required

PlayStat

gameId
​number · double · required
season
​number · double · required
week
​number · double · required
team
​string · required
conference
​string · required
opponent
​string · required
teamScore
​number · double · required
opponentScore
​number · double · required
driveId
​string · required
playId
​string · required
period
​number · double · required
​object · required
yardsToGoal
​number · double · required
down
​number · double · required
distance
​number · double · required
athleteId
​string · required
athleteName
​string · required
statType
​string · required
stat
​number · double · required

PlayStatType

id
​integer · int32 · required
name
​string · required

PlayoffCompetition.Cfp

string · enum
Enum values:
cfp

PlayoffStatus

string · enum
Enum values:
scheduled
selected
in_progress
completed

PlayoffTeam

id
​integer · int32 · required
school
​string · required
conference
​string | null · required

PlayoffBidType

string · enum
Enum values:
automatic
at_large

PlayoffOutcome

string · enum
Enum values:
active
eliminated
champion

PlayoffRound

string · enum
Enum values:
first_round
quarterfinal
semifinal
championship

PlayoffParticipant

​PlayoffTeam · required
committeeRank
​integer | null · int32 · required
seed
​integer · int32 · required
bidType
​PlayoffBidType · enum · required
Enum values:
automatic
at_large
qualificationReason
​string | null · required
conferenceChampion
​boolean · required
qualifyingConference
​string | null · required
firstRoundBye
​boolean · required
outcome
​PlayoffOutcome · enum · required
Enum values:
active
eliminated
champion
eliminatedRound
​string · enum · required
Enum values:
first_round
quarterfinal
semifinal
championship

PlayoffMatchupSlotSource

matchupId
​integer · int32 · required
bracketSlot
​string · required
outcome
​string · enum · required
Enum values:
winner

PlayoffMatchupSlot

position
​integer · int32 · required
seed
​integer | null · int32 · required
​object · required
​object · required

PlayoffLinkedGame

id
​integer · int32 · required
startDate
​string · date-time · required
completed
​boolean · required
​PlayoffTeam · required
homePoints
​integer | null · int32 · required
​PlayoffTeam · required
awayPoints
​integer | null · int32 · required
venueId
​integer | null · int32 · required
venue
​string | null · required

PlayoffAdvancement

matchupId
​integer · int32 · required
bracketSlot
​string · required
position
​integer · int32 · required

PlayoffMatchup

id
​integer · int32 · required
bracketSlot
​string · required
round
​PlayoffRound · enum · required
Enum values:
first_round
quarterfinal
semifinal
championship
roundName
​string · required
roundOrder
​integer · int32 · required
matchupOrder
​integer · int32 · required
startDate
​string | null · date-time · required
bowlName
​string | null · required
​PlayoffMatchupSlot[] · required
​object · required
​object · required

PlayoffRoundRecord

code
​PlayoffRound · enum · required
Enum values:
first_round
quarterfinal
semifinal
championship
name
​string · required
order
​integer · int32 · required
​PlayoffMatchup[] · required

CfpPlayoff

season
​integer · int32 · required
competition
​PlayoffCompetition.Cfp · enum · required
Enum values:
cfp
format
​string · required
teamCount
​integer · int32 · required
status
​PlayoffStatus · enum · required
Enum values:
scheduled
selected
in_progress
completed
​PlayoffParticipant[] · required
​PlayoffRoundRecord[] · required
​object · required

CfpPlayoffNotFound

message
​string · enum · required
Enum values:
CFP playoff not found

PlayerSearchTeamStint

team
​string · required
startYear
​integer | null · int32 · required
endYear
​integer | null · int32 · required

PlayerSearchResult

id
​string · required
team
​string · required
name
​string · required
firstName
​string | null · required
lastName
​string | null · required
weight
​integer | null · int32 · required
height
​number | null · double · required
jersey
​integer | null · int32 · required
position
​string · required
hometown
​string · required
teamColor
​string · required
teamColorSecondary
​string · required
activeStartYear
​integer | null · int32 · required
activeEndYear
​integer | null · int32 · required
​PlayerSearchTeamStint[] · required

PlayerPPAChartItem

playNumber
​integer · int32 · required
avgPPA
​number · double · required

PlayerUsage

season
​integer · int32 · required
id
​string · required
name
​string · required
position
​string · required
team
​string · required
conference
​string · required
​object · required

PlayerSeasonOverviewStat

name
​string · required
value
​string · required

PlayerSeasonOverviewCategory

name
​string · required
​PlayerSeasonOverviewStat[] · required

PlayerSeasonOverviewPPA

​object · required
​object · required

PlayerSeasonOverview

season
​integer · int32 · required
id
​string · required
name
​string · required
position
​string · required
team
​string · required
conference
​string · required
games
​integer · int32 · required
​object · required
​object
​PlayerSeasonOverviewPPA

ReturningProduction

season
​integer · int32 · required
team
​string · required
conference
​string · required
totalPPA
​number · double · required
totalPassingPPA
​number · double · required
totalReceivingPPA
​number · double · required
totalRushingPPA
​number · double · required
percentPPA
​number · double · required
percentPassingPPA
​number · double · required
percentReceivingPPA
​number · double · required
percentRushingPPA
​number · double · required
usage
​number · double · required
passingUsage
​number · double · required
receivingUsage
​number · double · required
rushingUsage
​number · double · required

TransferEligibility

string · enum
Enum values:
Withdrawn
TBD
PendingAppeal
SittingOne
Immediate

PlayerTransfer

season
​integer · int32 · required
firstName
​string · required
lastName
​string · required
position
​string · required
origin
​string · required
destination
​string | null · required
transferDate
​string | null · date-time · required
rating
​number | null · double · required
stars
​integer | null · int32 · required
eligibility
​string · enum · required
Enum values:
Withdrawn
TBD
PendingAppeal
SittingOne
Immediate

PredictedPointsValue

yardLine
​integer · int32 · required
predictedPoints
​number · double · required

TeamSeasonPredictedPointsAdded

season
​integer · int32 · required
conference
​string · required
team
​string · required
​object · required
​object · required

TeamGamePredictedPointsAdded

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 · required
opponent
​string · required
​object · required
​object · required

PlayerGamePredictedPointsAdded

season
​integer · int32 · required
week
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
id
​string · required
name
​string · required
position
​string · required
team
​string · required
opponent
​string · required
​object · required

PlayerSeasonPredictedPointsAdded

season
​integer · int32 · required
id
​string · required
name
​string · required
position
​string · required
team
​string · required
conference
​string · required
​object · required
​object · required

PlayWinProbability

gameId
​integer · int32 · required
playId
​string · required
playText
​string · required
homeId
​integer · int32 · required
home
​string · required
awayId
​integer · int32 · required
away
​string · required
spread
​number · double · required
homeBall
​boolean · required
homeScore
​integer · int32 · required
awayScore
​integer · int32 · required
yardLine
​integer · int32 · required
down
​integer · int32 · required
distance
​integer · int32 · required
homeWinProbability
​number · double · required
playNumber
​integer · int32 · required

PregameWinProbability

season
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
week
​integer · int32 · required
gameId
​integer · int32 · required
homeTeam
​string · required
awayTeam
​string · required
spread
​number · double · required
homeWinProbability
​number · double · required

FieldGoalEP

yardsToGoal
​integer · int32 · required
distance
​integer · int32 · required
expectedPoints
​number · double · required

LiveGameTeam

teamId
​integer · int32 · required
team
​string · required
homeAway
​string · enum · required
Enum values:
home
away
lineScores
​integer[] · required
points
​integer · int32 · required
drives
​integer · int32 · required
scoringOpportunities
​integer · int32 · required
pointsPerOpportunity
​number · double · required
averageStartYardLine
​number | null · double · required
plays
​integer · int32 · required
lineYards
​number · double · required
lineYardsPerRush
​number · double · required
secondLevelYards
​number · double · required
secondLevelYardsPerRush
​number · double · required
openFieldYards
​number · double · required
openFieldYardsPerRush
​number · double · required
epaPerPlay
​number · double · required
totalEpa
​number · double · required
passingEpa
​number · double · required
epaPerPass
​number · double · required
rushingEpa
​number · double · required
epaPerRush
​number · double · required
successRate
​number · double · required
standardDownSuccessRate
​number · double · required
passingDownSuccessRate
​number · double · required
explosiveness
​number · double · required
deserveToWin
​number · double

Deserve-to-win metric for this team

LiveGamePlay

id
​string · required
homeScore
​integer · int32 · required
awayScore
​integer · int32 · required
period
​integer · int32 · required
clock
​string · required
wallClock
​string · date-time · required
teamId
​integer · int32 · required
team
​string · required
down
​integer · int32 · required
distance
​integer · int32 · required
yardsToGoal
​integer · int32 · required
yardsGained
​integer · int32 · required
playTypeId
​integer · int32 · required
playType
​string · required
epa
​number | null · double · required
garbageTime
​boolean · required
success
​boolean · required
rushPass
​string · enum · required
Enum values:
rush
pass
other
downType
​string · enum · required
Enum values:
passing
standard
playText
​string · required

LiveGameDrive

id
​string · required
offenseId
​integer · int32 · required
offense
​string · required
defenseId
​integer · int32 · required
defense
​string · required
playCount
​integer · int32 · required
yards
​integer · int32 · required
startPeriod
​integer · int32 · required
startClock
​string | null · required
startYardsToGoal
​integer · int32 · required
endPeriod
​integer | null · int32 · required
endClock
​string | null · required
endYardsToGoal
​integer | null · int32 · required
duration
​string | null · required
scoringOpportunity
​boolean · required
result
​string · required
pointsGained
​integer · int32 · required
​LiveGamePlay[] · required

LiveGame

id
​integer · int32 · required
status
​string · required
period
​integer | null · int32 · required
clock
​string · required
possession
​string · required
down
​integer | null · int32 · required
distance
​integer | null · int32 · required
yardsToGoal
​integer | null · int32 · required
​LiveGameTeam[] · required
​LiveGameDrive[] · required

GameLine

provider
​string · required
spread
​number | null · double · required
formattedSpread
​string · required
spreadOpen
​number | null · double · required
overUnder
​number | null · double · required
overUnderOpen
​number | null · double · required
homeMoneyline
​number | null · double · required
awayMoneyline
​number | null · double · required

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

UserFeatureAccess

adjustedMetrics
​boolean · required
weather
​boolean · required
scoreboard
​boolean · required
livePlayByPlay
​boolean · required
graphQl
​boolean · required

UserInfo

patronLevel
​number · double · required
tierName
​string · required
monthlyLimit
​number | null · double · required
remainingCalls
​number | null · double · required
usedCalls
​number | null · double · required
resetAt
​string · required
sharedPool
​boolean · required
products
​string[] · required
​UserFeatureAccess · required

UserUsageWindow

start
​string · required
end
​string · required

UserUsageApi

string · enum
Enum values:
all
cfb
cbb

UserUsageTotals

requests
​number · double · required
cfbRequests
​number · double · required
cbbRequests
​number · double · required
uniqueEndpoints
​number · double · required

UserUsageEndpoint

api
​UserUsageApi · enum · required
Enum values:
all
cfb
cbb
endpoint
​string · required
requests
​number · double · required
lastUsedAt
​string · required

UserUsageRecentRequest

api
​UserUsageApi · enum · required
Enum values:
all
cfb
cbb
endpoint
​string · required
requestedAt
​string · required

UserUsage

​UserUsageWindow · required
api
​UserUsageApi · enum · required
Enum values:
all
cfb
cbb
​UserUsageTotals · required
​UserUsageEndpoint[] · required
​UserUsageRecentRequest[] · required

PlayoffCompetition

string · enum
Enum values:
cfp

GamePlayoff

competition
​PlayoffCompetition · enum · required
Enum values:
cfp
format
​string · required
round
​PlayoffRound · enum · required
Enum values:
first_round
quarterfinal
semifinal
championship
roundName
​string · required
bracketSlot
​string · required
homeSeed
​integer | null · int32 · required
awaySeed
​integer | null · int32 · required
bowlName
​string | null · required

Game

id
​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
startDate
​string · date-time · required
startTimeTBD
​boolean · required
completed
​boolean · required
neutralSite
​boolean · required
conferenceGame
​boolean · required
attendance
​integer | null · int32 · required
venueId
​integer | null · int32 · required
venue
​string | null · required
homeId
​integer · int32 · required
homeTeam
​string · required
homeConference
​string | null · required
homeClassification
​string · enum · required
Enum values:
fbs
fcs
ii
iii
homePoints
​integer | null · int32 · required
homeLineScores
​array | null · required
homePostgameWinProbability
​number | null · double · required
homePregameElo
​integer | null · int32 · required
homePostgameElo
​integer | null · int32 · required
awayId
​integer · int32 · required
awayTeam
​string · required
awayConference
​string | null · required
awayClassification
​string · enum · required
Enum values:
fbs
fcs
ii
iii
awayPoints
​integer | null · int32 · required
awayLineScores
​array | null · required
awayPostgameWinProbability
​number | null · double · required
awayPregameElo
​integer | null · int32 · required
awayPostgameElo
​integer | null · int32 · required
excitementIndex
​number | null · double · required
highlights
​string | null · required
notes
​string | null · required
​object · required

GameTeamStatsTeamStat

category
​string · required
stat
​string · required

GameTeamStatsTeam

teamId
​integer · int32 · required
team
​string · required
conference
​string | null · required
homeAway
​string · enum · required
Enum values:
home
away
points
​integer | null · int32 · required
​GameTeamStatsTeamStat[] · required

GameTeamStats

id
​integer · int32 · required
​GameTeamStatsTeam[] · required

GamePlayerStatPlayer

id
​string · required
name
​string · required
stat
​string · required

GamePlayerStatTypes

name
​string · required
​GamePlayerStatPlayer[] · required

GamePlayerStatCategories

name
​string · required
​GamePlayerStatTypes[] · required

GamePlayerStatsTeam

team
​string · required
conference
​string | null · required
homeAway
​string · enum · required
Enum values:
home
away
points
​integer | null · int32 · required
​GamePlayerStatCategories[] · required

GamePlayerStats

id
​integer · int32 · required
​GamePlayerStatsTeam[] · required

MediaType

string · enum
Enum values:
tv
radio
web
ppv
mobile

GameMedia

id
​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
startTime
​string · date-time · required
isStartTimeTBD
​boolean · required
homeTeam
​string · required
homeConference
​string | null · required
awayTeam
​string · required
awayConference
​string | null · required
mediaType
​MediaType · enum · required
Enum values:
tv
radio
web
ppv
mobile
outlet
​string · required

GameWeather

id
​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
startTime
​string · date-time · required
gameIndoors
​boolean · required
homeTeam
​string · required
homeConference
​string | null · required
awayTeam
​string · required
awayConference
​string | null · required
venueId
​integer · int32 · required
venue
​string · required
temperature
​number | null · double · required
dewPoint
​number | null · double · required
humidity
​number | null · double · required
precipitation
​number | null · double · required
snowfall
​number | null · double · required
windDirection
​number | null · double · required
windSpeed
​number | null · double · required
pressure
​number | null · double · required
weatherConditionCode
​number | null · double · required
weatherCondition
​string | null · required

TeamRecord

games
​integer · int32 · required
wins
​integer · int32 · required
losses
​integer · int32 · required
ties
​integer · int32 · required

TeamRecords

year
​integer · int32 · required
teamId
​integer · int32 · required
team
​string · required
classification
​string · enum · required
Enum values:
fbs
fcs
ii
iii
conference
​string · required
division
​string · required
expectedWins
​number | null · double · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required

CalendarWeek

season
​integer · int32 · required
week
​integer · int32 · required
seasonType
​SeasonType · enum · required
Enum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
startDate
​string · date-time · required
endDate
​string · date-time · required
firstGameStart
​string · date-time · deprecated
lastGameStart
​string · date-time · deprecated

GameStatus

string · enum
Enum values:
scheduled
in_progress
completed

ScoreboardGame

id
​integer · int32 · required
startDate
​string · date-time · required
startTimeTBD
​boolean · required
tv
​string | null · required
neutralSite
​boolean · required
conferenceGame
​boolean · required
status
​GameStatus · enum · required
Enum values:
scheduled
in_progress
completed
period
​integer | null · int32 · required
clock
​string | null · required
situation
​string | null · required
possession
​string | null · required
lastPlay
​string | null · required
​object · required
​object · required
​object · required
​object · required
​object · required

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

DraftTeam

location
​string · required
nickname
​string | null · required
displayName
​string | null · required
logo
​string | null · required

DraftPosition

name
​string · required
abbreviation
​string · required

DraftPick

collegeAthleteId
​integer | null · int32 · required
nflAthleteId
​integer · int32 · required
collegeId
​integer · int32 · required
collegeTeam
​string · required
collegeConference
​string | null · required
nflTeamId
​integer · int32 · required
nflTeam
​string · required
year
​integer · int32 · required
overall
​integer · int32 · required
round
​integer · int32 · required
pick
​integer · int32 · required
name
​string · required
position
​string · required
height
​number | null · double · required
weight
​integer | null · int32 · required
preDraftRanking
​integer | null · int32 · required
preDraftPositionRanking
​integer | null · int32 · required
preDraftGrade
​integer | null · int32 · required
​object · required

CoachSeason

teamId
​integer · int32 · required
school
​string · required
conference
​string | null · required
year
​integer · int32 · required
games
​integer · int32 · required
wins
​integer · int32 · required
losses
​integer · int32 · required
ties
​integer · int32 · required
winPercentage
​number | null · double · required
preseasonRank
​integer | null · int32 · required
postseasonRank
​integer | null · int32 · required
srs
​number | null · double · required
spOverall
​number | null · double · required
spOffense
​number | null · double · required
spDefense
​number | null · double · required

Coach

id
​integer · int32 · required
firstName
​string · required
lastName
​string · required
​CoachSeason[] · required
hireDate
​string | null · date-time · deprecated

CoachSeasonTeamReference

id
​integer · int32 · required
school
​string · required
conference
​string | null · required

CoachCareer

games
​integer · int32 · required
wins
​integer · int32 · required
losses
​integer · int32 · required
ties
​integer · int32 · required
winPercentage
​number | null · double · required
seasons
​integer · int32 · required
teams
​integer · int32 · required
firstYear
​integer · int32 · required
lastYear
​integer · int32 · required

CoachAlmaMater

id
​integer · int32 · required
school
​string · required

CoachProfile

id
​integer · int32 · required
firstName
​string · required
lastName
​string · required
displayName
​string | null · required
​object · required
​CoachCareer · required
birthDate
​string | null · required
​object · required
graduationYear
​integer | null · int32 · required
wikidataId
​string | null · required
hallOfFameYear
​integer | null · int32 · required

CoachNotFound

message
​string · enum · required
Enum values:
Coach not found

CoachReference

id
​integer · int32 · required
firstName
​string · required
lastName
​string · required

CoachRatingContext

spSpecialTeams
​number | null · double · required
strengthOfSchedule
​number | null · double · required
secondOrderWins
​number | null · double · required
fpi
​number | null · double · required
​object · required

CoachRecruitingContext

rank
​integer | null · int32 · required
points
​number | null · double · required
talent
​number | null · double · required

CoachPollResume

preseasonRank
​integer | null · int32 · required
postseasonRank
​integer | null · int32 · required
bestRank
​integer | null · int32 · required
weeksRanked
​integer · int32 · required
weeksTopTen
​integer · int32 · required

CoachRecord

games
​integer · int32 · required
wins
​integer · int32 · required
losses
​integer · int32 · required
ties
​integer · int32 · required
winPercentage
​number | null · double · required

CoachRecordSplits

​CoachRecord · required
​CoachRecord · required
​CoachRecord · required
​CoachRecord · required
​CoachRecord · required

CoachScoring

pointsFor
​integer · int32 · required
pointsAgainst
​integer · int32 · required
averagePointDifferential
​number | null · double · required

CfpCoachSeasonOutcome

string · enum
Enum values:
active
eliminated
champion

CoachCfpContext

appeared
​boolean · required
seed
​integer | null · int32 · required
outcome
​string · enum · required
Enum values:
active
eliminated
champion

CoachDraftContext

year
​integer · int32 · required
totalPicks
​integer · int32 · required
firstRoundPicks
​integer · int32 · required

DetailedCoachSeason

games
​integer · int32 · required
wins
​integer · int32 · required
losses
​integer · int32 · required
ties
​integer · int32 · required
winPercentage
​number | null · double · required
​CoachReference · required
​CoachSeasonTeamReference · required
year
​integer · int32 · required
preseasonRank
​integer | null · int32 · required
postseasonRank
​integer | null · int32 · required
srs
​number | null · double · required
spOverall
​number | null · double · required
spOffense
​number | null · double · required
spDefense
​number | null · double · required
​CoachRatingContext · required
​CoachRecruitingContext · required
​object · required
attributionComplete
​boolean · required
​object · required
​object · required
​CoachCfpContext · required
​object · required

CoachTeamReference

id
​integer · int32 · required
school
​string · required

CoachTenure

id
​integer · int32 · required
​CoachReference · required
​CoachTeamReference · required
hireDate
​string | null · required
startYear
​integer · int32 · required
endYear
​integer | null · int32 · required
effectiveStart
​string | null · date-time · required
effectiveEnd
​string | null · date-time · required
isInterim
​boolean · required
active
​boolean · required
seasons
​integer · int32 · required
​CoachRecord · required
attributionComplete
​boolean · required

StatsByQuarter

total
​number · double · required
quarter1
​number | null · double · required
quarter2
​number | null · double · required
quarter3
​number | null · double · required
quarter4
​number | null · double · required

TeamPPA

team
​string · required
plays
​integer · int32 · required
​StatsByQuarter · required
​StatsByQuarter · required
​StatsByQuarter · required

TeamSuccessRates

team
​string · required
​StatsByQuarter · required
​StatsByQuarter · required
​StatsByQuarter · required

TeamExplosiveness

team
​string · required
​StatsByQuarter · required

TeamRushingStats

team
​string · required
powerSuccess
​number · double · required
stuffRate
​number · double · required
lineYards
​number · double · required
lineYardsAverage
​number · double · required
secondLevelYards
​number · double · required
secondLevelYardsAverage
​number · double · required
openFieldYards
​number · double · required
openFieldYardsAverage
​number · double · required

TeamHavoc

team
​string · required
total
​number · double · required
frontSeven
​number · double · required
db
​number · double · required

TeamScoringOpportunities

team
​string · required
opportunities
​integer · int32 · required
points
​integer · int32 · required
pointsPerOpportunity
​number · double · required

TeamFieldPosition

team
​string · required
averageStart
​number · double · required
averageStartingPredictedPoints
​number · double · required

PlayerGameUsage

total
​number · double · required
quarter1
​number | null · double · required
quarter2
​number | null · double · required
quarter3
​number | null · double · required
quarter4
​number | null · double · required
rushing
​number · double · required
passing
​number · double · required
player
​string · required
team
​string · required
position
​string · required

PlayerStatsByQuarter

total
​number · double · required
quarter1
​number | null · double · required
quarter2
​number | null · double · required
quarter3
​number | null · double · required
quarter4
​number | null · double · required
rushing
​number · double · required
passing
​number · double · required

PlayerPPA

player
​string · required
team
​string · required
position
​string · required
​PlayerStatsByQuarter · required
​PlayerStatsByQuarter · required

AdvancedBoxScore

​object · required
​object · required
​object · required
On this page
  • AdjustedTeamMetrics
  • PlayerWeightedEPA
  • KickerPAAR
  • Venue
  • Team
  • MatchupGame
  • Matchup
  • TeamATS
  • RosterPlayer
  • DivisionClassification
  • Conference
  • TeamTalent
  • PlayerStat
  • SeasonType
  • PlayerSuccessRateSplit
  • PlayerSeasonSuccessRate
  • SeasonTypeDB
  • PlayerGameSuccessRate
  • TeamStat
  • AdvancedSeasonStat
  • AdvancedGameStat
  • GameHavocStats
  • RecruitClassification
  • Recruit
  • TeamRecruitingRanking
  • AggregatedTeamRecruiting
  • CoreRatingSeasonType
  • TeamCoreRating
  • TeamSP
  • ConferenceSP
  • TeamSRS
  • ExpandedTeamSRS
  • TeamElo
  • TeamFPI
  • PollRank
  • Poll
  • PollWeek
  • RankingPoll
  • Play
  • PlayType
  • PlayStat
  • PlayStatType
  • PlayoffCompetition.Cfp
  • PlayoffStatus
  • PlayoffTeam
  • PlayoffBidType
  • PlayoffOutcome
  • PlayoffRound
  • PlayoffParticipant
  • PlayoffMatchupSlotSource
  • PlayoffMatchupSlot
  • PlayoffLinkedGame
  • PlayoffAdvancement
  • PlayoffMatchup
  • PlayoffRoundRecord
  • CfpPlayoff
  • CfpPlayoffNotFound
  • PlayerSearchTeamStint
  • PlayerSearchResult
  • PlayerPPAChartItem
  • PlayerUsage
  • PlayerSeasonOverviewStat
  • PlayerSeasonOverviewCategory
  • PlayerSeasonOverviewPPA
  • PlayerSeasonOverview
  • ReturningProduction
  • TransferEligibility
  • PlayerTransfer
  • PredictedPointsValue
  • TeamSeasonPredictedPointsAdded
  • TeamGamePredictedPointsAdded
  • PlayerGamePredictedPointsAdded
  • PlayerSeasonPredictedPointsAdded
  • PlayWinProbability
  • PregameWinProbability
  • FieldGoalEP
  • LiveGameTeam
  • LiveGamePlay
  • LiveGameDrive
  • LiveGame
  • GameLine
  • BettingGame
  • UserFeatureAccess
  • UserInfo
  • UserUsageWindow
  • UserUsageApi
  • UserUsageTotals
  • UserUsageEndpoint
  • UserUsageRecentRequest
  • UserUsage
  • PlayoffCompetition
  • GamePlayoff
  • Game
  • GameTeamStatsTeamStat
  • GameTeamStatsTeam
  • GameTeamStats
  • GamePlayerStatPlayer
  • GamePlayerStatTypes
  • GamePlayerStatCategories
  • GamePlayerStatsTeam
  • GamePlayerStats
  • MediaType
  • GameMedia
  • GameWeather
  • TeamRecord
  • TeamRecords
  • CalendarWeek
  • GameStatus
  • ScoreboardGame
  • Drive
  • DraftTeam
  • DraftPosition
  • DraftPick
  • CoachSeason
  • Coach
  • CoachSeasonTeamReference
  • CoachCareer
  • CoachAlmaMater
  • CoachProfile
  • CoachNotFound
  • CoachReference
  • CoachRatingContext
  • CoachRecruitingContext
  • CoachPollResume
  • CoachRecord
  • CoachRecordSplits
  • CoachScoring
  • CfpCoachSeasonOutcome
  • CoachCfpContext
  • CoachDraftContext
  • DetailedCoachSeason
  • CoachTeamReference
  • CoachTenure
  • StatsByQuarter
  • TeamPPA
  • TeamSuccessRates
  • TeamExplosiveness
  • TeamRushingStats
  • TeamHavoc
  • TeamScoringOpportunities
  • TeamFieldPosition
  • PlayerGameUsage
  • PlayerStatsByQuarter
  • PlayerPPA
  • AdvancedBoxScore