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

# GET /passing/plays

`GET /passing/plays`

Returns enriched pass attempts.

## Query parameters

- `year` integer, required
- `team` string
- `week` integer
- `gameId` integer
- `seasonType` 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'
- `offense` string
- `defense` string
- `conference` string
- `passerId` string
- `targetId` string
- `outcome` 'completion' | 'incompletion' | 'interception'
- `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii'

## Response `200`

Ok

- PassingPlay[]
  - `gameId` integer, required
  - `playId` string, required
  - `driveId` string, required
  - `season` integer, required
  - `week` integer, required
  - `seasonType` 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason', required
  - `offenseId` integer, required
  - `offense` string, required
  - `offenseConference` string, nullable, required
  - `defenseId` integer, required
  - `defense` string, required
  - `defenseConference` string, nullable, required
  - `period` integer, required
  - `clock` PassingPlayClock, required
    - `minutes` integer, required
    - `seconds` integer, required
  - `down` integer, required
  - `distance` integer, required
  - `playText` string, nullable, required
  - `passerId` string, nullable, required
  - `passer` string, nullable, required
  - `targetId` string, nullable, required
  - `target` string, nullable, required
  - `outcome` 'completion' | 'incompletion' | 'interception', required
  - `airYards` integer, nullable, required
  - `passDepth` 'short' | 'deep', required
  - `passDirection` 'left' | 'middle' | 'right', required
  - `passLocation` 'short left' | 'short middle' | 'short right' | 'deep left' | 'deep middle' | 'deep right', required
  - `totalYards` integer, nullable, required
  - `yardsAfterCatch` integer, nullable, required
  - `startYardline` integer, required
  - `startYardsToGoal` integer, required
  - `targetYardsToGoal` integer, nullable, required
  - `isSpike` boolean, required
  - `isThrowaway` boolean, required
  - `isIntentionalGrounding` boolean, required
  - `parseStatus` 'complete' | 'partial' | 'invalid', required

## Changes

- **2026-08-30** `d2759ca81b00` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/changes/passing/plays/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/c44a00d614f0?raw)