Multi-table

Plays

Use for play-by-play with advanced metrics: EPA, WPA, win probability, success, CPOE, air yards, formation flags, and the players involved. Filter by game, or by season plus week/team/player, plus play type, down, quarter, win-probability band, red zone, third down. Returns a per-query EPA and success-rate summary. Paginate with offset. Costs 10 credits.

post/v1/get_plays

Request

  • Base URL: https://mcp.endzoneapi.com
  • URL: https://mcp.endzoneapi.com/v1/get_plays
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

game_idstring

Game id, e.g. 2025_01_KC_BUF

weekinteger

Week

posteamstring

Offense team code

defteamstring

Defense team code

play_type'pass' | 'run' | 'punt' | 'kickoff' | 'field_goal' | 'extra_point' | 'qb_kneel' | 'qb_spike' | 'no_play'

Play type

downinteger

Down

quarterinteger

Quarter (5+ = overtime)

passer_idstring

GSIS id of the passer

rusher_idstring

GSIS id of the rusher

receiver_idstring

GSIS id of the receiver

min_wpnumber

Minimum pre-play win probability for the offense

max_wpnumber

Maximum pre-play win probability

red_zoneboolean

Only plays inside the 20

third_downboolean

Only third downs

limitinteger

Max plays (default 200)

offsetinteger

Pagination offset

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.