passing

GET /passing/players/season

Changed on

Returns passer production, CPOE, advanced metrics, and pass-location breakdowns by season.

Request

  • Base URL
    https://api.collegefootballdata.com
  • Auth
    HTTP bearer

Query parameters

yearinteger

Season year. Required unless passerId is specified.

seasonType'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'

Season type.

teamstring

Team name.

conferencestring

Conference name or abbreviation.

passerIdstring

Passer athlete ID. Required unless year is specified.

classification'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii'

Division classification. Defaults to fbs.

Response

Ok

attemptsinteger required
completionsinteger required
incompletionsinteger required
interceptionsinteger required
completionRatenumber double nullable required
airYardsAttemptsAvailableinteger required

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

totalAirYardsinteger nullable required
averageDepthOfTargetnumber double nullable required
totalYardsAttemptsAvailableinteger required

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

totalYardsinteger nullable required
yardsAfterCatchAttemptsAvailableinteger required

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

totalYardsAfterCatchinteger nullable required
averageYardsAfterCatchnumber double nullable required
successRatenumber double required

Successful eligible attempts / all eligible attempts; zero if empty.

ppanumber double required

Average available PPA on eligible attempts; zero if unavailable.

totalPpanumber double required

Sum of available PPA on eligible attempts; zero if unavailable.

explosivenessnumber double required

Average available PPA on successful eligible attempts; zero if unavailable.

ppaAttemptsAvailableinteger required

Eligible attempts with non-null PPA, including zero and negative values.

successAttemptsAvailableinteger required

Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.

successfulAttemptsinteger required

Eligible attempts with stored success equal to true.

successfulPpaAttemptsAvailableinteger required

Successful eligible attempts with non-null PPA; explosiveness denominator.

cpoeAttemptsAvailableinteger required

Attempts with a completion probability; denominator for CPOE metrics.

cpoeCompletionsinteger required

Completions among attempts with a completion probability.

expectedCompletionsnumber double nullable required

Sum of completion probabilities; null if unavailable.

expectedCompletionRatenumber double nullable required

Expected completions / cpoeAttemptsAvailable; null if unavailable.

cpoenumber double nullable required

Completion percentage over expected, in percentage points; null if unavailable.

locationEligibleAttemptsinteger required

Attempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.

locationAvailableAttemptsinteger required

Eligible attempts with both recognized source depth and direction.

seasoninteger required
playerIdstring required
playerstring required
teamstring required
conferencestring nullable required

Changes

    • info

      added the required property items/cpoe to the response with the status

    • info

      added the required property items/cpoeAttemptsAvailable to the response with the status

    • info

      added the required property items/cpoeCompletions to the response with the status

    2 more changes in this revision