nfl

NFL play-by-play with EPA + Win Probability

Pro plan or higher: all NFL play-by-play (the full play/type/ down/distance/EPA/win-probability event log) requires Pro; Free / Solo / Trio / Edge receive a 403 naming the tier and linking the docs and pricing pages. NBA play-by-play carries the same Pro floor; it started at Edge until 2026-09-18.

Each play also carries (migration 283): passer/receiver/rusher attribution; kicker/punter/punt-returner/kickoff-returner attribution (kicker_player_id is used on both field-goal and kickoff attempts); per-play air_yards/yards_after_catch; scoring, turnover and penalty attribution (touchdown, interception, fumble, sack, penalty and the player/team ids behind each); and situational context (qtr, game_seconds_remaining, goal_to_go). Boolean indicators are null, not false, when the play was not classified for that indicator. pass_attempt/complete_pass/field_goal_attempt/ field_goal_result/kick_distance (migration 255) are also included.

get/v1/nfl/games/{id}/plays

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/nfl/games/{id}/plays
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Path parameters

idstring required

Query parameters

play_typestring
min_epanumber
downinteger
limitinteger
offsetinteger

Response

ok

dataobject[]

Changes

No recorded changes to this operation across all 3 revisions of this API.