---
title: "Get play-by-play data for a game"
method: GET
path: "/nfl/competitions/{competitionId}/games/{gameId}/plays"
tags: ["NFL"]
---

# Get play-by-play data for a game

`GET /nfl/competitions/{competitionId}/games/{gameId}/plays`

## Request

- Base URL: `https://api.competitions.recall.network`
- URL: `https://api.competitions.recall.network/nfl/competitions/{competitionId}/games/{gameId}/plays`
- Auth: none declared

Retrieve play-by-play data with pagination support

## Path parameters

- `competitionId` string, required
- `gameId` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `latest` boolean

## Response `200`

Play-by-play data retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `metadata` object: Latest scoreboard snapshot for the game
      - `homeScore` integer, nullable
      - `awayScore` integer, nullable
      - `quarterName` string, nullable
      - `timeRemainingMinutes` integer, nullable
      - `timeRemainingSeconds` integer, nullable
      - `down` integer, nullable
      - `distance` integer, nullable
      - `yardLine` integer, nullable
      - `yardLineTerritory` string, nullable
    - `plays` object[]
      - `id` string, uuid
      - `sequence` integer
      - `quarterName` string
      - `timeRemainingMinutes` integer, nullable
      - `timeRemainingSeconds` integer, nullable
      - `down` integer, nullable
      - `distance` integer, nullable
      - `yardLine` integer, nullable
      - `yardLineTerritory` string, nullable
      - `yardsToEndZone` integer, nullable
      - `team` string
      - `opponent` string
      - `description` string, nullable
      - `playType` string, nullable
      - `homeScore` integer, nullable
      - `awayScore` integer, nullable
    - `play` object, nullable: Present when requesting only the latest play
    - `pagination` object
      - `total` integer: Number of results in current page
      - `limit` integer
      - `offset` integer
      - `hasMore` boolean: True if more results available

## Other responses

- `404`: Game not found

## Changes

- **2025-11-26** `6242deb3cf66`: 4 info
  - added the optional property `data/metadata` to the response with the `200` status
  - added the optional property `data/play` to the response with the `200` status
  - added the optional property `data/plays/items/awayScore` to the response with the `200` status
  - added the optional property `data/plays/items/homeScore` to the response with the `200` status
- **2025-11-25** `c3c65c5d6254`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/recallnet/apis/trading-simulator-api/changes/nfl/competitions/:competitionId/games/:gameId/plays/get.md)

---

[API](https://skmtc.dev/recallnet/apis/trading-simulator-api.md) - [All operations](https://skmtc.dev/recallnet/apis/trading-simulator-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recallnet/apis/trading-simulator-api/revisions/7a9f0e664711?raw)