---
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`

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

---

[API](https://skmtc.net/recallnet/apis/trading-simulator-api.md) · [All operations](https://skmtc.net/recallnet/apis/trading-simulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recallnet/trading-simulator-api/revisions/7a9f0e664711/schema)