punting

GET /punting/plays

Changed on

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

Request

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

Query parameters

gameIdinteger

Game ID.

yearinteger

Season year. Required unless gameId is specified.

weekinteger

Week number. Either week, a team filter, punterId, or returnerId is required with year.

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

Season type.

teamstring

Team name on either side of the punt.

puntingTeamstring

Punting team name.

receivingTeamstring

Receiving team name.

conferencestring

Conference name or abbreviation on either side of the punt.

punterIdstring

Punter athlete ID.

returnerIdstring

Returner athlete ID.

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

Division classification. Defaults to fbs.

Response

Ok

gameIdinteger required
playIdstring required
driveIdstring nullable required
seasoninteger required
weekinteger required
seasonType'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason' required
puntingTeamIdinteger required
puntingTeamstring required
puntingConferencestring nullable required
receivingTeamIdinteger required
receivingTeamstring required
receivingConferencestring nullable required
periodinteger required
downinteger required
distanceinteger nullable required
playTypestring required
playTextstring nullable required
punterIdstring nullable required
punterstring nullable required
receiverIdstring nullable required
receiverstring nullable required
returnerIdstring nullable required
returnerstring nullable required
blockerIdstring nullable required
blockerstring nullable required
countsAsPuntboolean nullable required

Whether the play counts as a punt; null when unknown.

countsAsReturnboolean nullable required

Whether the play counts as a punt return; null when unknown.

startYardsToGoalinteger nullable required
puntYardsinteger nullable required

Gross punt yards.

returnYardsinteger nullable required

Return yards for the receiving team.

returnerYardsinteger nullable required

Return yards credited to the returner; null when not credited individually.

netPuntYardsinteger nullable required

Gross punt yards minus return yards, less 20 yards for a touchback.

kickEndYardlineinteger nullable required

Where the kick ended, from the punting team's goal line (0) to the receiving team's goal line (100).

endYardlineinteger nullable required

Where the play ended, on the same scale as kickEndYardline.

isTouchbackboolean nullable required
isFairCatchboolean nullable required
isOutOfBoundsboolean nullable required
isDownedboolean nullable required
isBlockedboolean nullable required
isMuffedboolean nullable required
isReturnTouchdownboolean nullable required
isReceivingTeamTurnoverboolean nullable required

The receiving team lost possession, such as on a muff or fumble.

hasPenaltyboolean nullable required
parseStatus'complete' | 'partial' required

Changes