---
title: "Play-by-play for a game (Pro Insights+, NFL/NBA/MLB/NHL/CFB/Soccer)"
method: GET
path: "/v1/{sport}/games/{gameId}/plays"
tags: ["Multi"]
---

# Play-by-play for a game (Pro Insights+, NFL/NBA/MLB/NHL/CFB/Soccer)

`GET /v1/{sport}/games/{gameId}/plays`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/{sport}/games/{gameId}/plays`
- Auth: API key in header `X-PlayCaller-Key`

Full play-by-play feed for a game, sourced live from ESPN's game summary endpoint (not stored/replayed -- reflects the current ESPN state at request time).

**Tier access:** Pro Insights, Syndicate Alpha

## Path parameters

- `sport` 'nfl' | 'nba' | 'mlb' | 'nhl' | 'cfb' | 'soccer', required
- `gameId` string, required

## Response `200`

Play-by-play

- object
  - `success` boolean
  - `endpoint` string
  - `sport` string
  - `game_id` string
  - `game` object
    - `home_team` string, nullable
    - `away_team` string, nullable
    - `home_score` string, nullable
    - `away_score` string, nullable
    - `status` string, nullable
  - `play_count` integer
  - `plays` object[]
    - `id` string, nullable
    - `sequence` string, nullable
    - `text` string, nullable
    - `period` integer, nullable
    - `clock` string, nullable
    - `team` string, nullable
    - `type` string, nullable
    - `scoring_play` boolean
    - `score_away` string, nullable
    - `score_home` string, nullable
    - `coordinate_x` number, nullable
    - `coordinate_y` number, nullable

## Other responses

- `400`: Play-by-play not supported for this sport
- `401`: Missing or invalid API key
- `402`: Pro Insights or Syndicate Alpha required
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error
- `502`: ESPN upstream unavailable

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)