College Football Data API
​integer · int32 · required​integer · int32 · required​string · required​string · required​number · double · required​number · double · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​number · double · required​integer · int32 · required​integer · int32 · required​string · required​string · required​string · required​string · required​number · double · required​integer · int32 · required​integer | null · int32 · required​string | null · required​string | null · required​string | null · required​string | null · required​string | null · required​string | null · required​number | null · double · required​number | null · double · required​string | null · required​integer | null · int32 · required​integer | null · int32 · required​boolean | null​boolean | null​integer · int32 · required​string · required​string | null · required​string | null · required​array | null · required​string | null · required​string | null · required​string | null · required​string | null · required​string | null · required​array | null · required​string | null · required​integer · int32 · required​integer · int32 · required​string · required​string · required​boolean · required​string | null · required​string · required​integer | null · int32 · required​string · required​integer | null · int32 · required​string | null · required​string · required​string · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32​integer · int32​integer · int32 · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number | null · double · required​string · required​string · required​string · required​string · required​number | null · double · required​integer | null · int32 · required​integer | null · int32 · required​string | null · required​string | null · required​string | null · required​string | null · required​number | null · double · required​number | null · double · required​string | null · required​array | null · required​integer · int32 · deprecated​integer · int32 · required​string · required​string | null · required​string | null · required​string · enum · required​integer · int32 · required​integer · int32 · required​string · required​integer · int32 · required​string · required​string | null · required​string · enum · required​integer · int32 · required​string · required​string | null · required​string · enum · required​integer · int32 · required​integer · int32 · required​string · required​integer · int32 · required​string · required​string | null · required​string · enum · required​string | null · required​integer · int32 · required​integer | null · int32 · required​integer · int32 · required​string · required​number · double · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​string · required​string · required​string · required​integer · int32 · required​integer · int32 · required​number | null · double · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​integer · int32 · required​SeasonTypeDB · enum · required​integer · int32 · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​string · required​integer · int32 · required​string · required​string · required​string · required​integer · int32 · required​string · required​string · required​integer · int32 · required​integer · int32 · required​SeasonTypeDB · enum · required​integer · int32 · required​string · required​string · required​integer · int32 · required​integer · int32 · required​SeasonTypeDB · enum · required​integer · int32 · required​string · required​string | null · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​string · required​string · required​integer · int32 · required​integer · int32 · required​SeasonType · enum · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​string | null · required​integer · int32 · required​integer | null · int32 · required​string | null · required​string | null · required​string · enum · required​integer | null · int32 · required​integer | null · int32 · required​boolean | null · required​boolean · required​boolean · required​boolean · required​RushAttributionStatus · enum · required​boolean · required​RushParseStatus · enum · required​number | null · double · required​boolean | null · required​integer · int32 · required​integer · int32 · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​integer · int32 · required​integer · int32 · required​integer | null · int32 · required​number | null · double · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​integer · int32 · required​string · required​string · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer | null · int32 · required​number | null · double · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​SeasonType · enum · required​string · required​string · required​string · required​string | null · required​string · required​integer · int32 · required​integer · int32 · required​integer | null · int32 · required​number | null · double · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​SeasonType · enum · required​string · required​string | null · required​string · required​string · required​string | null · required​RecruitClassification · enum · required​integer · int32 · required​integer | null · int32 · required​string · required​string | null · required​string | null · required​string | null · required​number | null · double · required​integer | null · int32 · required​integer | null · int32 · required​number | null · double · required​string | null · required​string | null · required​string | null · required​integer · int32 · required​integer · int32 · required​string · required​number · double · required​string · required​string · required​string | null · required​number · double · required​number · double · required​integer · int32 · required​number · double · required​integer · int32 · required​CoreRatingSeasonType · enum · required​integer · int32 · required​string · required​string | null · required​number · double · required​number · double · required​number · double · required​integer · int32 · required​integer · int32 · required​string · required​integer · int32 · required​string · required​string | null · required​number · double · required​integer | null · int32 · required​number | null · double · required​number | null · double · required​integer · int32 · required​string · required​number · double · required​number | null · double · required​number | null · double · required​integer · int32 · required​string · required​string | null · required​string | null · required​number · double · required​integer | null · int32 · required​integer · int32 · required​string · required​string | null · required​string | null · required​number · double · required​integer | null · int32 · required​DivisionClassification · enum · required​integer · int32 · required​string · required​string · required​integer | null · int32 · required​integer · int32 · required​string · required​string | null · required​number | null · double · required​integer | null · int32 · required​integer · int32 · required​string · required​string | null · required​integer | null · int32 · required​integer | null · int32 · required​integer · int32 · required​SeasonType · enum · required​integer · int32 · required​string · required​string · required​integer · int32 · required​integer | null · int32 · required​integer | null · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer | null · int32 · required​integer | null · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​boolean · required​string · required​string | null · required​number | null · double · required​string | null · required​integer · int32 · required​string · required​string | null · required​number · double · required​number · double · required​number · double · required​string · required​string · required​string · required​number · double · required​number · double · required​string · required​string · required​number · double · required​number · double · required​number · double · required​number · double · required​string · required​string · required​string · required​number · double · required​integer · int32 · required​string · required​string | null · required​integer | null · int32 · required​integer · int32 · required​PlayoffBidType · enum · required​string | null · required​boolean · required​string | null · required​boolean · required​PlayoffOutcome · enum · required​string · enum · required​integer · int32 · required​string · required​string · enum · required​integer · int32 · required​integer | null · int32 · required​integer · int32 · required​string · date-time · required​boolean · required​integer | null · int32 · required​integer | null · int32 · required​integer | null · int32 · required​string | null · required​integer · int32 · required​string · required​integer · int32 · required​integer · int32 · required​string · required​PlayoffRound · enum · required​string · required​integer · int32 · required​integer · int32 · required​string | null · date-time · required​string | null · required​PlayoffRound · enum · required​string · required​integer · int32 · required​integer · int32 · required​PlayoffCompetition.Cfp · enum · required​string · required​integer · int32 · required​PlayoffStatus · enum · required​string · required​integer | null · int32 · required​integer | null · int32 · required​string · required​string · required​string · required​string | null · required​string | null · required​integer | null · int32 · required​number | null · double · required​integer | null · int32 · required​string · required​string · required​string · required​string · required​integer | null · int32 · required​integer | null · int32 · required​integer · int32 · required​number · double · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​string · required​integer · int32 · required​string · required​string · required​string · required​string · required​string · required​integer · int32 · required​integer · int32 · required​string · required​string · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​number · double · required​integer · int32 · required​string · required​string · required​string · required​string · required​string | null · required​string | null · date-time · required​number | null · double · required​integer | null · int32 · required​string · enum · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​string · required​string · required​integer · int32 · required​integer · int32 · required​SeasonType · enum · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​string · required​string | null · required​integer · int32 · required​integer · int32 · required​integer · int32 · required​string | null · required​string | null · required​string | null · required​string | null · required​string | null · required​PassOutcome · enum · required​integer | null · int32 · required​string · enum · required​string · enum · required​string · enum · required​integer | null · int32 · required​integer | null · int32 · required​integer · int32 · required​integer · int32 · required​integer | null · int32 · required​boolean · required​boolean · required​boolean · required​PassParseStatus · enum · required​number | null · double · required​boolean | null · required​boolean · required
Schemas
AdjustedTeamMetrics
yearteamIdteamconference​object · required
​object · required
​object · required
​object · required
​object · required
​object · required
explosivenessexplosivenessAllowedPlayerWeightedEPA
yearathleteIdathleteNamepositionteamconferencewepaplaysKickerPAAR
yearathleteIdathleteNameteamconferencepaarattemptsVenue
idnamecitystatezipcountryCodetimezonelatitudelongitudeelevationcapacityconstructionYeargrassdomeTeam
idschoolmascotabbreviationalternateNamesconferencedivisionclassificationcoloralternateColorlogostwitter​object · required
MatchupGame
seasonweekseasonTypedateneutralSitevenuehomeTeamhomeScoreawayTeamawayScorewinnerMatchup
team1team2team1Winsteam2Winsties​MatchupGame[] · required
startYearendYearTeamATS
yearteamIdteamconferencegamesatsWinsatsLossesatsPushesavgCoverMarginRosterPlayer
idfirstNamelastNameteamheightweightjerseypositionhomeCityhomeStatehomeCountryhomeLatitudehomeLongitudehomeCountyFIPSrecruitIdsyearConference
idnameshortNameabbreviationclassificationEnum values:
fbs
fcs
ii
ii/iii
iii
memberCountTeamConferenceChange
teamIdteamfromConferenceIdfromConferencefromConferenceAbbreviationfromClassificationEnum values:
fbs
fcs
ii
ii/iii
iii
toConferenceIdtoConferencetoConferenceAbbreviationtoClassificationEnum values:
fbs
fcs
ii
ii/iii
iii
effectiveYearTeamConferenceAffiliation
teamIdteamconferenceIdconferenceconferenceAbbreviationclassificationEnum values:
fbs
fcs
ii
ii/iii
iii
conferenceDivisionstartYearendYearTeamTalent
yearteamtalentPlayerStat
seasonplayerIdplayerpositionteamconferencecategorystatTypestatPlayerSuccessRateSplit
playssuccessessuccessRatePlayerSeasonSuccessRate
seasonidnamepositionteamconference​PlayerSuccessRateSplit · required
​PlayerSuccessRateSplit · required
SeasonTypeDB
string · enum
Enum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
PlayerGameSuccessRate
seasonseasonTypeEnum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
weekgameIdidnamepositionteamconferenceopponent​PlayerSuccessRateSplit · required
​PlayerSuccessRateSplit · required
TeamStat
seasonteamconferencestatName​required
AdvancedSeasonStat
seasonteamconference​object · required
​object · required
AdvancedGameStat
gameIdseasonseasonTypeEnum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
weekteamopponent​object · required
​object · required
GameHavocStats
gameIdseasonseasonTypeEnum values:
allstar
postseason
preseason
regular
spring_postseason
spring_regular
weekteamconferenceopponentopponentConference​object · required
​object · required
RushingPlayClock
minutessecondsRushAttributionStatus
string · enum
Enum values:
individual
team
multi_carrier
unmatched
ambiguous
conflict
unlinked
RushingPlay
gameIdplayIddriveIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
offenseIdoffenseoffenseConferencedefenseIddefensedefenseConferenceperiod​RushingPlayClock · required
downdistanceplayTextstartYardlinestartYardsToGoalrusherIdrusherrushDirectionEnum values:
left
middle
right
rushingYardsrusherYardsisRushingTouchdownisSackisKneelisTeamRushattributionStatusEnum values:
individual
team
multi_carrier
unmatched
ambiguous
conflict
unlinked
directionAnalysisEligibleparseStatusEnum values:
complete
partial
invalid
ppasuccessRushingDirectionProduction
carriesyardsyardsPerCarrysuccessRateppatotalPpalineYardslineYardsTotalsecondLevelYardssecondLevelYardsTotalopenFieldYardsopenFieldYardsTotalstuffRatepowerSuccessexplosivenessPlayerRushingSeason
attemptsrushingYardsAvailabletotalRushingYardsyardsPerCarryindividualAttemptsunattributedAttemptssackskneelsteamRushesmultiCarrierAttemptsdirectionEligibleAttemptsdirectionAvailableAttemptssuccessRateppatotalPpalineYardslineYardsTotalsecondLevelYardssecondLevelYardsTotalopenFieldYardsopenFieldYardsTotalstuffRatepowerSuccessexplosiveness​object · required
seasonplayerIdplayerteamconferencePlayerRushingGame
attemptsrushingYardsAvailabletotalRushingYardsyardsPerCarryindividualAttemptsunattributedAttemptssackskneelsteamRushesmultiCarrierAttemptsdirectionEligibleAttemptsdirectionAvailableAttemptssuccessRateppatotalPpalineYardslineYardsTotalsecondLevelYardssecondLevelYardsTotalopenFieldYardsopenFieldYardsTotalstuffRatepowerSuccessexplosiveness​object · required
gameIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
playerIdplayerteamconferenceopponentTeamRushingProduction
attemptsrushingYardsAvailabletotalRushingYardsyardsPerCarryindividualAttemptsunattributedAttemptssackskneelsteamRushesmultiCarrierAttemptsdirectionEligibleAttemptsdirectionAvailableAttemptssuccessRateppatotalPpalineYardslineYardsTotalsecondLevelYardssecondLevelYardsTotalopenFieldYardsopenFieldYardsTotalstuffRatepowerSuccessexplosiveness​object · required
touchdownStatusAvailablerushingTouchdownsTeamRushingSeason
seasonteamconference​TeamRushingProduction · required
​TeamRushingProduction · required
TeamRushingGame
gameIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
teamconferenceopponent​TeamRushingProduction · required
​TeamRushingProduction · required
Recruit
idathleteIdrecruitTypeEnum values:
JUCO
PrepSchool
HighSchool
yearrankingnameschoolcommittedTopositionheightweightstarsratingcitystateProvincecountry​object · required
TeamRecruitingRanking
yearrankteampointsAggregatedTeamRecruiting
teamconferencepositionGroupaverageRatingtotalRatingcommitsaverageStarsTeamCoreRating
yearthroughSeasonTypeEnum values:
regular
postseason
throughWeekteamconferenceoverallOffense-minus-defense composite; higher is better.
offensePoints created above average per 100 qualifying plays; higher is better.
defensePoints allowed above average per 100 qualifying plays; lower is better.
offensePlaysdefensePlaysmodelVersionTeamSP
yearteamconferenceratingrankingsecondOrderWinssos​object · required
​object · required
​object · required
ConferenceSP
yearconferenceratingsecondOrderWinssos​object · required
​object · required
​object · required
TeamSRS
yearteamconferencedivisionratingrankingExpandedTeamSRS
yearteamconferencedivisionratingrankingclassificationEnum values:
fbs
fcs
ii
ii/iii
iii
TeamElo
yearteamconferenceeloTeamFPI
yearteamconferencefpi​object · required
​object · required
PollRank
rankteamIdschoolconferencefirstPlaceVotespointsPollWeek
seasonseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
week​Poll[] · required
Play
iddriveIdgameIddriveNumberplayNumberoffenseoffenseConferenceoffenseScoredefensehomeawaydefenseConferencedefenseScoreperiod​object · required
offenseTimeoutsdefenseTimeoutsyardlineyardsToGoaldowndistanceyardsGainedscoringplayTypeplayTextppawallclockPlayType
idtextabbreviationPlayStat
gameIdseasonweekteamconferenceopponentteamScoreopponentScoredriveIdplayIdperiod​object · required
yardsToGoaldowndistanceathleteIdathleteNamestatTypestatPlayoffTeam
idschoolconferencePlayoffParticipant
​PlayoffTeam · required
committeeRankseedbidTypeEnum values:
automatic
at_large
qualificationReasonconferenceChampionqualifyingConferencefirstRoundByeoutcomeEnum values:
active
eliminated
champion
eliminatedRoundEnum values:
first_round
quarterfinal
semifinal
championship
PlayoffMatchupSlotSource
matchupIdbracketSlotoutcomeEnum values:
winner
PlayoffMatchupSlot
positionseed​object · required
​object · required
PlayoffLinkedGame
idstartDatecompleted​PlayoffTeam · required
homePoints​PlayoffTeam · required
awayPointsvenueIdvenuePlayoffAdvancement
matchupIdbracketSlotpositionPlayoffMatchup
idbracketSlotroundEnum values:
first_round
quarterfinal
semifinal
championship
roundNameroundOrdermatchupOrderstartDatebowlName​PlayoffMatchupSlot[] · required
​object · required
​object · required
PlayoffRoundRecord
codeEnum values:
first_round
quarterfinal
semifinal
championship
nameorder​PlayoffMatchup[] · required
CfpPlayoff
seasoncompetitionEnum values:
cfp
formatteamCountstatusEnum values:
scheduled
selected
in_progress
completed
​PlayoffParticipant[] · required
​PlayoffRoundRecord[] · required
​object · required
PlayerSearchTeamStint
teamstartYearendYearPlayerSearchResult
idteamnamefirstNamelastNameweightheightjerseypositionhometownteamColorteamColorSecondaryactiveStartYearactiveEndYear​PlayerSearchTeamStint[] · required
PlayerPPAChartItem
playNumberavgPPAPlayerUsage
seasonidnamepositionteamconference​object · required
PlayerSeasonOverviewCategory
name​PlayerSeasonOverviewStat[] · required
PlayerSeasonOverview
seasonidnamepositionteamconferencegames​object · required
​object
ReturningProduction
seasonteamconferencetotalPPAtotalPassingPPAtotalReceivingPPAtotalRushingPPApercentPPApercentPassingPPApercentReceivingPPApercentRushingPPAusagepassingUsagereceivingUsagerushingUsagePlayerTransfer
seasonfirstNamelastNamepositionorigindestinationtransferDateratingstarseligibilityEnum values:
Withdrawn
TBD
PendingAppeal
SittingOne
Immediate
PassingPlayClock
minutessecondsPassLocation
string · enum
Enum values:
short left
short middle
short right
deep left
deep middle
deep right
PassingPlay
gameIdplayIddriveIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
offenseIdoffenseoffenseConferencedefenseIddefensedefenseConferenceperiod​PassingPlayClock · required
downdistanceplayTextpasserIdpassertargetIdtargetoutcomeEnum values:
completion
incompletion
interception
airYardspassDepthEnum values:
short
deep
passDirectionEnum values:
left
middle
right
passLocationEnum values:
short left
short middle
short right
deep left
deep middle
deep right
totalYardsyardsAfterCatchstartYardlinestartYardsToGoaltargetYardsToGoalisSpikeisThrowawayisIntentionalGroundingparseStatusEnum values:
complete
partial
invalid
ppaStored offensive PPA, including zero and negative values.
successStored success classification; null means unavailable.
locationAnalysisEligibleExcludes spikes, intentional grounding, and invalid parses. Throwaways, partial parses, and attempts with missing location or air yards qualify.
PassingLocationProduction
Production for analysis-eligible attempts in one location bucket.
attemptscompletionsincompletionsinterceptionscompletionRateairYardsAttemptsAvailableNumber of attempts with non-null air yards, including zero-yard values.
totalAirYardsaverageDepthOfTargettotalYardsAttemptsAvailableNumber of attempts with non-null total yards, including zero-yard incompletions and interceptions.
totalYardsyardsAfterCatchAttemptsAvailableNumber of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
totalYardsAfterCatchaverageYardsAfterCatchsuccessRateSuccessful eligible attempts / all eligible attempts; zero if empty.
ppaAverage available PPA on eligible attempts; zero if unavailable.
totalPpaSum of available PPA on eligible attempts; zero if unavailable.
explosivenessAverage available PPA on successful eligible attempts; zero if unavailable.
ppaAttemptsAvailableEligible attempts with non-null PPA, including zero and negative values.
successAttemptsAvailableEligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
successfulAttemptsEligible attempts with stored success equal to true.
successfulPpaAttemptsAvailableSuccessful eligible attempts with non-null PPA; explosiveness denominator.
yardsPerAttemptTotal yards / attempts with total yards available; null if unavailable.
airYardsPerAttemptTotal air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
PassingLocations
​PassingLocationProduction · required
Production for analysis-eligible attempts in one location bucket.
​PassingLocationProduction · required
Production for analysis-eligible attempts in one location bucket.
​PassingLocationProduction · required
Production for analysis-eligible attempts in one location bucket.
​PassingLocationProduction · required
Production for analysis-eligible attempts in one location bucket.
​PassingLocationProduction · required
Production for analysis-eligible attempts in one location bucket.
​PassingLocationProduction · required
Production for analysis-eligible attempts in one location bucket.
​PassingLocationProduction · required
Eligible attempts without both recognized depth and direction.
PlayerPassingSeason
attemptscompletionsincompletionsinterceptionscompletionRateairYardsAttemptsAvailableNumber of attempts with non-null air yards, including zero-yard values.
totalAirYardsaverageDepthOfTargettotalYardsAttemptsAvailableNumber of attempts with non-null total yards, including zero-yard incompletions and interceptions.
totalYardsyardsAfterCatchAttemptsAvailableNumber of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
totalYardsAfterCatchaverageYardsAfterCatchsuccessRateSuccessful eligible attempts / all eligible attempts; zero if empty.
ppaAverage available PPA on eligible attempts; zero if unavailable.
totalPpaSum of available PPA on eligible attempts; zero if unavailable.
explosivenessAverage available PPA on successful eligible attempts; zero if unavailable.
ppaAttemptsAvailableEligible attempts with non-null PPA, including zero and negative values.
successAttemptsAvailableEligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
successfulAttemptsEligible attempts with stored success equal to true.
successfulPpaAttemptsAvailableSuccessful eligible attempts with non-null PPA; explosiveness denominator.
locationEligibleAttemptsAttempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.
locationAvailableAttemptsEligible attempts with both recognized source depth and direction.
​PassingLocations · required
All seven buckets are present, including empty buckets.
seasonplayerIdplayerteamconferencePlayerPassingGame
attemptscompletionsincompletionsinterceptionscompletionRateairYardsAttemptsAvailableNumber of attempts with non-null air yards, including zero-yard values.
totalAirYardsaverageDepthOfTargettotalYardsAttemptsAvailableNumber of attempts with non-null total yards, including zero-yard incompletions and interceptions.
totalYardsyardsAfterCatchAttemptsAvailableNumber of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
totalYardsAfterCatchaverageYardsAfterCatchsuccessRateSuccessful eligible attempts / all eligible attempts; zero if empty.
ppaAverage available PPA on eligible attempts; zero if unavailable.
totalPpaSum of available PPA on eligible attempts; zero if unavailable.
explosivenessAverage available PPA on successful eligible attempts; zero if unavailable.
ppaAttemptsAvailableEligible attempts with non-null PPA, including zero and negative values.
successAttemptsAvailableEligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
successfulAttemptsEligible attempts with stored success equal to true.
successfulPpaAttemptsAvailableSuccessful eligible attempts with non-null PPA; explosiveness denominator.
locationEligibleAttemptsAttempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.
locationAvailableAttemptsEligible attempts with both recognized source depth and direction.
​PassingLocations · required
All seven buckets are present, including empty buckets.
gameIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
playerIdplayerteamconferenceopponentPassingProduction
Defense reports opponent production allowed without inverting PPA signs.
attemptscompletionsincompletionsinterceptionscompletionRateairYardsAttemptsAvailableNumber of attempts with non-null air yards, including zero-yard values.
totalAirYardsaverageDepthOfTargettotalYardsAttemptsAvailableNumber of attempts with non-null total yards, including zero-yard incompletions and interceptions.
totalYardsyardsAfterCatchAttemptsAvailableNumber of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
totalYardsAfterCatchaverageYardsAfterCatchsuccessRateSuccessful eligible attempts / all eligible attempts; zero if empty.
ppaAverage available PPA on eligible attempts; zero if unavailable.
totalPpaSum of available PPA on eligible attempts; zero if unavailable.
explosivenessAverage available PPA on successful eligible attempts; zero if unavailable.
ppaAttemptsAvailableEligible attempts with non-null PPA, including zero and negative values.
successAttemptsAvailableEligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
successfulAttemptsEligible attempts with stored success equal to true.
successfulPpaAttemptsAvailableSuccessful eligible attempts with non-null PPA; explosiveness denominator.
locationEligibleAttemptsAttempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.
locationAvailableAttemptsEligible attempts with both recognized source depth and direction.
​PassingLocations · required
All seven buckets are present, including empty buckets.
TeamPassingSeason
seasonteamconference​PassingProduction · required
Defense reports opponent production allowed without inverting PPA signs.
​PassingProduction · required
Defense reports opponent production allowed without inverting PPA signs.
TeamPassingGame
gameIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
teamconferenceopponent​PassingProduction · required
Defense reports opponent production allowed without inverting PPA signs.
​PassingProduction · required
Defense reports opponent production allowed without inverting PPA signs.
PredictedPointsValue
yardLinepredictedPointsTeamSeasonPredictedPointsAdded
seasonconferenceteam​object · required
​object · required
TeamGamePredictedPointsAdded
gameIdseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
teamconferenceopponent​object · required
​object · required
PlayerGamePredictedPointsAdded
seasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
idnamepositionteamopponent​object · required
PlayerSeasonPredictedPointsAdded
seasonidnamepositionteamconference​object · required
​object · required
PlayWinProbability
gameIdplayIdplayTexthomeIdhomeawayIdawayspreadhomeBallhomeScoreawayScoreyardLinedowndistancehomeWinProbabilityplayNumberPregameWinProbability
seasonseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
weekgameIdhomeTeamawayTeamspreadhomeWinProbabilityFieldGoalEP
yardsToGoaldistanceexpectedPointsLiveGameTeam
teamIdteamhomeAwayEnum values:
home
away
lineScorespointsdrivesscoringOpportunitiespointsPerOpportunityaverageStartYardLineplayslineYardslineYardsPerRushsecondLevelYardssecondLevelYardsPerRushopenFieldYardsopenFieldYardsPerRushepaPerPlaytotalEpapassingEpaepaPerPassrushingEpaepaPerRushsuccessRatestandardDownSuccessRatepassingDownSuccessRateexplosivenessdeserveToWinDeserve-to-win metric for this team
LiveGamePlay
idhomeScoreawayScoreperiodclockwallClockteamIdteamdowndistanceyardsToGoalyardsGainedplayTypeIdplayTypeepagarbageTimesuccessrushPassEnum values:
rush
pass
other
downTypeEnum values:
passing
standard
playTextLiveGameDrive
idoffenseIdoffensedefenseIddefenseplayCountyardsstartPeriodstartClockstartYardsToGoalendPeriodendClockendYardsToGoaldurationscoringOpportunityresultpointsGained​LiveGamePlay[] · required
LiveGame
idstatusperiodclockpossessiondowndistanceyardsToGoal​LiveGameTeam[] · required
​LiveGameDrive[] · required
GameLine
providerspreadformattedSpreadspreadOpenoverUnderoverUnderOpenhomeMoneylineawayMoneylineBettingGame
idseasonseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
weekstartDatehomeTeamIdhomeTeamhomeConferencehomeClassificationEnum values:
fbs
fcs
ii
ii/iii
iii
homeScoreawayTeamIdawayTeamawayConferenceawayClassificationEnum values:
fbs
fcs
ii
ii/iii
iii
awayScore​GameLine[] · required
UserFeatureAccess
adjustedMetricsweatherscoreboardlivePlayByPlaygraphQlUserInfo
patronLeveltierNamemonthlyLimitremainingCallsusedCallsresetAtsharedPoolproducts​UserFeatureAccess · required
UserUsageTotals
requestscfbRequestscbbRequestsuniqueEndpointsUserUsageEndpoint
apiEnum values:
all
cfb
cbb
endpointrequestslastUsedAtUserUsageRecentRequest
apiEnum values:
all
cfb
cbb
endpointrequestedAtUserUsage
​UserUsageWindow · required
apiEnum values:
all
cfb
cbb
​UserUsageTotals · required
​UserUsageEndpoint[] · required
​UserUsageRecentRequest[] · required
GamePlayoff
competitionEnum values:
cfp
formatroundEnum values:
first_round
quarterfinal
semifinal
championship
roundNamebracketSlothomeSeedawaySeedbowlNameGame
idseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
startDatestartTimeTBDcompletedneutralSiteconferenceGameattendancevenueIdvenuehomeIdhomeTeamhomeConferencehomeClassificationEnum values:
fbs
fcs
ii
ii/iii
iii
homePointshomeLineScoreshomePostgameWinProbabilityhomePregameElohomePostgameEloawayIdawayTeamawayConferenceawayClassificationEnum values:
fbs
fcs
ii
ii/iii
iii
awayPointsawayLineScoresawayPostgameWinProbabilityawayPregameEloawayPostgameEloexcitementIndexhighlightsnotes​object · required
GameTeamStatsTeam
teamIdteamconferencehomeAwayEnum values:
home
away
points​GameTeamStatsTeamStat[] · required
GameTeamStats
id​GameTeamStatsTeam[] · required
GamePlayerStatPlayer
idnamestatGamePlayerStatTypes
name​GamePlayerStatPlayer[] · required
GamePlayerStatCategories
name​GamePlayerStatTypes[] · required
GamePlayerStatsTeam
teamconferencehomeAwayEnum values:
home
away
points​GamePlayerStatCategories[] · required
GamePlayerStats
id​GamePlayerStatsTeam[] · required
GameMedia
idseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
startTimeisStartTimeTBDhomeTeamhomeConferenceawayTeamawayConferencemediaTypeEnum values:
tv
radio
web
ppv
mobile
outletGameWeather
idseasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
startTimegameIndoorshomeTeamhomeConferenceawayTeamawayConferencevenueIdvenuetemperaturedewPointhumidityprecipitationsnowfallwindDirectionwindSpeedpressureweatherConditionCodeweatherConditionTeamRecord
gameswinslossestiesTeamRecords
yearteamIdteamclassificationEnum values:
fbs
fcs
ii
ii/iii
iii
conferencedivisionexpectedWins​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
​TeamRecord · required
CalendarWeek
seasonweekseasonTypeEnum values:
regular
postseason
both
allstar
spring_regular
spring_postseason
startDateendDatefirstGameStartlastGameStartScoreboardGame
idstartDatestartTimeTBDtvneutralSiteconferenceGamestatusEnum values:
scheduled
in_progress
completed
periodclocksituationpossessionlastPlay​object · required
​object · required
​object · required
​object · required
​object · required
Drive
offenseoffenseConferencedefensedefenseConferencegameIdiddriveNumberscoringstartPeriodstartYardlinestartYardsToGoal​object · required
endPeriodendYardlineendYardsToGoal​object · required
​object · required
playsyardsdriveResultisHomeOffensestartOffenseScorestartDefenseScoreendOffenseScoreendDefenseScoreDraftTeam
locationnicknamedisplayNamelogoDraftPick
collegeAthleteIdnflAthleteIdcollegeIdcollegeTeamcollegeConferencenflTeamIdnflTeamyearoverallroundpicknamepositionheightweightpreDraftRankingpreDraftPositionRankingpreDraftGrade​object · required
CoachSeason
teamIdschoolconferenceyeargameswinslossestieswinPercentagepreseasonRankpostseasonRanksrsspOverallspOffensespDefenseCoach
idfirstNamelastName​CoachSeason[] · required
hireDateCoachSeasonTeamReference
idschoolconferenceCoachCareer
gameswinslossestieswinPercentageseasonsteamsfirstYearlastYearCoachProfile
idfirstNamelastNamedisplayName​object · required
​CoachCareer · required
birthDate​object · required
graduationYearwikidataIdhallOfFameYearCoachReference
idfirstNamelastNameCoachRatingContext
spSpecialTeamsstrengthOfSchedulesecondOrderWinsfpi​object · required
CoachRecruitingContext
rankpointstalentCoachPollResume
preseasonRankpostseasonRankbestRankweeksRankedweeksTopTenCoachRecord
gameswinslossestieswinPercentageCoachRecordSplits
​CoachRecord · required
​CoachRecord · required
​CoachRecord · required
​CoachRecord · required
​CoachRecord · required
CoachScoring
pointsForpointsAgainstaveragePointDifferentialCoachCfpContext
appearedseedoutcomeEnum values:
active
eliminated
champion
CoachDraftContext
yeartotalPicksfirstRoundPicksDetailedCoachSeason
gameswinslossestieswinPercentage​CoachReference · required
​CoachSeasonTeamReference · required
yearpreseasonRankpostseasonRanksrsspOverallspOffensespDefense​CoachRatingContext · required
​CoachRecruitingContext · required
​object · required
attributionComplete​object · required
​object · required
​CoachCfpContext · required
​object · required
CoachTenure
id​CoachReference · required
​CoachTeamReference · required
hireDatestartYearendYeareffectiveStarteffectiveEndisInterimactiveseasons​CoachRecord · required
attributionCompleteStatsByQuarter
totalquarter1quarter2quarter3quarter4TeamPPA
teamplays​StatsByQuarter · required
​StatsByQuarter · required
​StatsByQuarter · required
TeamSuccessRates
team​StatsByQuarter · required
​StatsByQuarter · required
​StatsByQuarter · required
TeamExplosiveness
team​StatsByQuarter · required
TeamRushingStats
teampowerSuccessstuffRatelineYardslineYardsAveragesecondLevelYardssecondLevelYardsAverageopenFieldYardsopenFieldYardsAverageTeamHavoc
teamtotalfrontSevendbTeamScoringOpportunities
teamopportunitiespointspointsPerOpportunityTeamFieldPosition
teamaverageStartaverageStartingPredictedPointsPlayerGameUsage
totalquarter1quarter2quarter3quarter4rushingpassingplayerteampositionPlayerStatsByQuarter
totalquarter1quarter2quarter3quarter4rushingpassingPlayerPPA
playerteamposition​PlayerStatsByQuarter · required
​PlayerStatsByQuarter · required