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

# GET /punting/plays

`GET /punting/plays`

## Request

- Base URL: `https://api.collegefootballdata.com`
- URL: `https://api.collegefootballdata.com/punting/plays`
- Auth: HTTP bearer

Returns enriched punt plays with gross, return, and net yardage, field
position, and punt outcomes.

## Query parameters

- `gameId` integer
- `year` integer
- `week` integer
- `seasonType` 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason'
- `team` string
- `puntingTeam` string
- `receivingTeam` string
- `conference` string
- `punterId` string
- `returnerId` string
- `classification` 'fbs' | 'fcs' | 'ii' | 'ii/iii' | 'iii'

## Response `200`

Ok

- PuntingPlay[]
  - `gameId` integer, required
  - `playId` string, required
  - `driveId` string, nullable, required
  - `season` integer, required
  - `week` integer, required
  - `seasonType` 'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason', required
  - `puntingTeamId` integer, required
  - `puntingTeam` string, required
  - `puntingConference` string, nullable, required
  - `receivingTeamId` integer, required
  - `receivingTeam` string, required
  - `receivingConference` string, nullable, required
  - `period` integer, required
  - `clock` PuntingPlayClock, required
    - `minutes` integer, required
    - `seconds` integer, required
  - `down` integer, required
  - `distance` integer, nullable, required
  - `playType` string, required
  - `playText` string, nullable, required
  - `punterId` string, nullable, required
  - `punter` string, nullable, required
  - `receiverId` string, nullable, required
  - `receiver` string, nullable, required
  - `returnerId` string, nullable, required
  - `returner` string, nullable, required
  - `blockerId` string, nullable, required
  - `blocker` string, nullable, required
  - `countsAsPunt` boolean, nullable, required: Whether the play counts as a punt; null when unknown.
  - `countsAsReturn` boolean, nullable, required: Whether the play counts as a punt return; null when unknown.
  - `startYardsToGoal` integer, nullable, required
  - `puntYards` integer, nullable, required: Gross punt yards.
  - `returnYards` integer, nullable, required: Return yards for the receiving team.
  - `returnerYards` integer, nullable, required: Return yards credited to the returner; null when not credited individually.
  - `netPuntYards` integer, nullable, required: Gross punt yards minus return yards, less 20 yards for a touchback.
  - `kickEndYardline` integer, nullable, required: Where the kick ended, from the punting team's goal line (0) to the receiving team's goal line (100).
  - `endYardline` integer, nullable, required: Where the play ended, on the same scale as kickEndYardline.
  - `isTouchback` boolean, nullable, required
  - `isFairCatch` boolean, nullable, required
  - `isOutOfBounds` boolean, nullable, required
  - `isDowned` boolean, nullable, required
  - `isBlocked` boolean, nullable, required
  - `isMuffed` boolean, nullable, required
  - `isReturnTouchdown` boolean, nullable, required
  - `isReceivingTeamTurnover` boolean, nullable, required: The receiving team lost possession, such as on a muff or fumble.
  - `hasPenalty` boolean, nullable, required
  - `parseStatus` 'complete' | 'partial', required

## Changes

- **2026-10-19** `305ee3eba6f7`: 1 info
  - endpoint added

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