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

# GET /punting/players/season

`GET /punting/players/season`

## Request

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

Returns individually attributed punting and punt return production by
season.

Player totals do not include team-only or unattributed punts and returns,
and therefore are not expected to sum to team totals.

## Query parameters

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

## Response `200`

Ok

- PlayerPuntingSeason[]
  - `season` integer, required
  - `playerId` string, required
  - `player` string, required
  - `team` string, required
  - `conference` string, nullable, required
  - `punting` PlayerPuntingProduction, nullable, required: Production on punts kicked by a player.
    - `punts` integer, required
    - `puntYardsAvailable` integer, required: Punts with known gross yards.
    - `puntYards` integer, nullable, required
    - `yardsPerPunt` number, double, nullable, required
    - `longestPunt` integer, nullable, required
    - `punts50Plus` integer, required
    - `netPuntYardsAvailable` integer, required: Punts with known net yards.
    - `netPuntYards` integer, nullable, required
    - `netYardsPerPunt` number, double, nullable, required
    - `touchbacks` integer, required
    - `fairCatches` integer, required
    - `outOfBounds` integer, required
    - `downed` integer, required
    - `inside20` integer, required: Punts after which the receiving team took possession inside its own 20, excluding touchbacks.
    - `blocked` integer, required
  - `returning` PlayerPuntReturnProduction, nullable, required: Production on punts fielded, returned, or blocked by a player.
    - `returns` integer, required
    - `returnYardsAvailable` integer, required: Returns with known yards.
    - `returnYards` integer, nullable, required
    - `yardsPerReturn` number, double, nullable, required
    - `longestReturn` integer, nullable, required
    - `returns20Plus` integer, required
    - `returnTouchdowns` integer, required
    - `fairCatches` integer, required
    - `muffs` integer, required
    - `blocks` integer, required

## Changes

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

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