Passing
Enriched pass attempts and player and team passing production.
Returns enriched pass attempts with stored PPA, success, and location-analysis eligibility.
query Parameters
yearSeason year.
teamTeam name on either side of the pass. Either team or week is required.
weekWeek number. Either team or week is required.
gameIdGame ID.
seasonTypeSeason type.
offenseOffensive team name.
defenseDefensive team name.
conferenceConference name or abbreviation on either side of the pass.
passerIdPasser athlete ID.
targetIdIntended target athlete ID.
outcomePass outcome.
classificationDivision classification. Defaults to fbs.
Responses
Ok
gameIdplayIddriveIdseasonweekseasonTypeoffenseIdoffenseoffenseConferencedefenseIddefensedefenseConferenceperioddowndistanceplayTextpasserIdpassertargetIdtargetoutcomeairYardspassDepthpassDirectionpassLocationtotalYardsyardsAfterCatchstartYardlinestartYardsToGoaltargetYardsToGoalisSpikeisThrowawayisIntentionalGroundingparseStatusppaStored offensive PPA, including zero and negative values.
successStored success classification; null means unavailable.
locationAnalysisEligibleExcludes spikes, intentional grounding, and invalid parses. Throwaways, partial parses, and attempts with missing location or air yards qualify.
Returns passer production, advanced metrics, and pass-location breakdowns by season.
query Parameters
yearSeason year. Required unless passerId is specified.
seasonTypeSeason type.
teamTeam name.
conferenceConference name or abbreviation.
passerIdPasser athlete ID. Required unless year is specified.
classificationDivision classification. Defaults to fbs.
Responses
Ok
attemptscompletionsincompletionsinterceptionscompletionRateairYardsAttemptsAvailableNumber of attempts with non-null air yards, including zero-yard values.
totalAirYardsaverageDepthOfTargettotalYardsAttemptsAvailableNumber of attempts with non-null total yards, including zero-yard incompletions and interceptions.
totalYardsyardsAfterCatchAttemptsAvailableNumber of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
totalYardsAfterCatchaverageYardsAfterCatchsuccessRateSuccessful eligible attempts / all eligible attempts; zero if empty.
ppaAverage available PPA on eligible attempts; zero if unavailable.
totalPpaSum of available PPA on eligible attempts; zero if unavailable.
explosivenessAverage available PPA on successful eligible attempts; zero if unavailable.
ppaAttemptsAvailableEligible attempts with non-null PPA, including zero and negative values.
successAttemptsAvailableEligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
successfulAttemptsEligible attempts with stored success equal to true.
successfulPpaAttemptsAvailableSuccessful eligible attempts with non-null PPA; explosiveness denominator.
locationEligibleAttemptsAttempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.
locationAvailableAttemptsEligible attempts with both recognized source depth and direction.
All seven buckets are present, including empty buckets.
seasonplayerIdplayerteamconferenceReturns passer production, advanced metrics, and pass-location breakdowns by game.
query Parameters
yearSeason year. Required.
weekWeek number. Either passerId, team, or week is required.
seasonTypeSeason type.
teamTeam name. Either passerId, team, or week is required.
conferenceConference name or abbreviation.
passerIdPasser athlete ID. Either passerId, team, or week is required.
classificationDivision classification. Defaults to fbs.
Responses
Ok
attemptscompletionsincompletionsinterceptionscompletionRateairYardsAttemptsAvailableNumber of attempts with non-null air yards, including zero-yard values.
totalAirYardsaverageDepthOfTargettotalYardsAttemptsAvailableNumber of attempts with non-null total yards, including zero-yard incompletions and interceptions.
totalYardsyardsAfterCatchAttemptsAvailableNumber of completed attempts with valid total yards and air yards to calculate yards after catch, including zero-yard values.
totalYardsAfterCatchaverageYardsAfterCatchsuccessRateSuccessful eligible attempts / all eligible attempts; zero if empty.
ppaAverage available PPA on eligible attempts; zero if unavailable.
totalPpaSum of available PPA on eligible attempts; zero if unavailable.
explosivenessAverage available PPA on successful eligible attempts; zero if unavailable.
ppaAttemptsAvailableEligible attempts with non-null PPA, including zero and negative values.
successAttemptsAvailableEligible attempts with non-null success. Missing success remains in the success-rate denominator but does not count as successful.
successfulAttemptsEligible attempts with stored success equal to true.
successfulPpaAttemptsAvailableSuccessful eligible attempts with non-null PPA; explosiveness denominator.
locationEligibleAttemptsAttempts eligible for advanced metrics and location analysis. Existing overall production includes ineligible attempts; location buckets do not.
locationAvailableAttemptsEligible attempts with both recognized source depth and direction.
All seven buckets are present, including empty buckets.
gameIdseasonweekseasonTypeplayerIdplayerteamconferenceopponentReturns team passing production, advanced metrics, and pass-location breakdowns by season for offense and defense.
query Parameters
yearSeason year. Required unless team is specified.
seasonTypeSeason type.
teamTeam name. Required unless year is specified.
conferenceConference name or abbreviation.
classificationDivision classification. Defaults to fbs.
Responses
Ok
seasonteamconferenceDefense reports opponent production allowed without inverting PPA signs.
Defense reports opponent production allowed without inverting PPA signs.
Returns team passing production, advanced metrics, and pass-location breakdowns by game for offense and defense.
query Parameters
yearSeason year. Required.
weekWeek number. Either team or week is required.
seasonTypeSeason type.
teamTeam name. Either team or week is required.
conferenceConference name or abbreviation.
classificationDivision classification. Defaults to fbs.
Responses
Ok
gameIdseasonweekseasonTypeteamconferenceopponentDefense reports opponent production allowed without inverting PPA signs.
Defense reports opponent production allowed without inverting PPA signs.