Sign in
passing

Returns enriched pass attempts with stored PPA, success, and location-analysis eligibility.

get/passing/plays

Query parameters

yearinteger required

Season year.

teamstring

Team name on either side of the pass. Either team or week is required.

weekinteger

Week number. Either team or week is required.

gameIdinteger

Game ID.

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

Season type.

offensestring

Offensive team name.

defensestring

Defensive team name.

conferencestring

Conference name or abbreviation on either side of the pass.

passerIdstring

Passer athlete ID.

targetIdstring

Intended target athlete ID.

outcome'completion' | 'incompletion' | 'interception'

Pass outcome.

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

Division classification. Defaults to fbs.

Response

Ok

gameIdinteger required
playIdstring required
driveIdstring required
seasoninteger required
weekinteger required
seasonType'regular' | 'postseason' | 'both' | 'allstar' | 'spring_regular' | 'spring_postseason' required
offenseIdinteger required
offensestring required
offenseConferencestring nullable required
defenseIdinteger required
defensestring required
defenseConferencestring nullable required
periodinteger required
downinteger required
distanceinteger required
playTextstring nullable required
passerIdstring nullable required
passerstring nullable required
targetIdstring nullable required
targetstring nullable required
outcome'completion' | 'incompletion' | 'interception' required
airYardsinteger 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
totalYardsinteger nullable required
yardsAfterCatchinteger nullable required
startYardlineinteger required
startYardsToGoalinteger required
targetYardsToGoalinteger nullable required
isSpikeboolean required
isThrowawayboolean required
isIntentionalGroundingboolean required
parseStatus'complete' | 'partial' | 'invalid' required
ppanumber double nullable required

Stored offensive PPA, including zero and negative values.

successboolean nullable required

Stored success classification; null means unavailable.

locationAnalysisEligibleboolean required

Excludes spikes, intentional grounding, and invalid parses. Throwaways, partial parses, and attempts with missing location or air yards qualify.

Changes

Changed in 2 of the 14 revisions of this API.4

  • 596229ca59f83See the full diff
    • ○

      added the required property / to the response with the status

      response-required-property-added

    • ○

      added the required property / to the response with the status

      response-required-property-added

    • ○

      added the required property / to the response with the status

      response-required-property-added

  • d2759ca81b001See the full diff
    • ○

      endpoint added

      endpoint-added