---
title: "GET /passing/players/season"
method: GET
path: "/passing/players/season"
tags: ["passing"]
---

# GET /passing/players/season

`GET /passing/players/season`

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

## Query parameters

- `year` integer
- `seasonType` 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'
- `team` string
- `conference` string
- `passerId` string
- `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii'

## Response `200`

Ok

- PlayerPassingSeason[]
  - `attempts` integer, required
  - `completions` integer, required
  - `incompletions` integer, required
  - `interceptions` integer, required
  - `completionRate` number, double, nullable, required
  - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
  - `totalAirYards` integer, nullable, required
  - `averageDepthOfTarget` number, double, nullable, required
  - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
  - `totalYards` integer, nullable, required
  - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
  - `totalYardsAfterCatch` integer, nullable, required
  - `averageYardsAfterCatch` number, double, nullable, required
  - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
  - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
  - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
  - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
  - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
  - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
  - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
  - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
  - `locationEligibleAttempts` integer, required — Attempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.
  - `locationAvailableAttempts` integer, required — Eligible attempts with both recognized source depth and direction.
  - `locations` PassingLocations, required
    - `short left` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
    - `short middle` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
    - `short right` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
    - `deep left` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
    - `deep middle` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
    - `deep right` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
    - `unknown` PassingLocationProduction, required — Production for analysis-eligible attempts in one location bucket.
      - `attempts` integer, required
      - `completions` integer, required
      - `incompletions` integer, required
      - `interceptions` integer, required
      - `completionRate` number, double, nullable, required
      - `airYardsAttemptsAvailable` integer, required — Number of attempts with non-null air yards, including zero-yard values.
      - `totalAirYards` integer, nullable, required
      - `averageDepthOfTarget` number, double, nullable, required
      - `totalYardsAttemptsAvailable` integer, required — Number of attempts with non-null total yards, including zero-yard incompletions and interceptions.
      - `totalYards` integer, nullable, required
      - `yardsAfterCatchAttemptsAvailable` integer, required — Number of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
      - `totalYardsAfterCatch` integer, nullable, required
      - `averageYardsAfterCatch` number, double, nullable, required
      - `successRate` number, double, required — Successful eligible attempts / all eligible attempts; zero if empty.
      - `ppa` number, double, required — Average available PPA on eligible attempts; zero if unavailable.
      - `totalPpa` number, double, required — Sum of available PPA on eligible attempts; zero if unavailable.
      - `explosiveness` number, double, required — Average available PPA on successful eligible attempts; zero if unavailable.
      - `ppaAttemptsAvailable` integer, required — Eligible attempts with non-null PPA, including zero and negative values.
      - `successAttemptsAvailable` integer, required — Eligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
      - `successfulAttempts` integer, required — Eligible attempts with stored success equal to true.
      - `successfulPpaAttemptsAvailable` integer, required — Successful eligible attempts with non-null PPA; explosiveness denominator.
      - `yardsPerAttempt` number, double, nullable, required — Total yards / attempts with total yards available; null if unavailable.
      - `airYardsPerAttempt` number, double, nullable, required — Total air yards / attempts with air yards available; null if unavailable. Equivalent to averageDepthOfTarget. Yardage averages use one decimal.
  - `season` integer, required
  - `playerId` string, required
  - `player` string, required
  - `team` string, required
  - `conference` string, nullable, required

## Changes

- **2026-09-08** `596229ca59f8` — 11 info
  - added the required property `items/explosiveness` to the response with the `200` status
  - added the required property `items/locationAvailableAttempts` to the response with the `200` status
  - added the required property `items/locationEligibleAttempts` to the response with the `200` status
  - added the required property `items/locations` to the response with the `200` status
  - …7 more
- **2026-08-30** `d2759ca81b00` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/changes/passing/players/season/get.md)

---

[API](https://skmtc.dev/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/revisions/57dbeaf157dc?raw)