---
title: "GET /live/plays"
method: GET
path: "/live/plays"
tags: ["plays"]
---

# GET /live/plays

`GET /live/plays`

Returns live play-by-play data and advanced metrics for a game.

## Query parameters

- `gameId` integer, required

## Response `200`

Ok

- LiveGame
  - `id` integer, required
  - `status` string, required
  - `period` integer, nullable, required
  - `clock` string, required
  - `possession` string, required
  - `down` integer, nullable, required
  - `distance` integer, nullable, required
  - `yardsToGoal` integer, nullable, required
  - `teams` LiveGameTeam[], required
    - `teamId` integer, required
    - `team` string, required
    - `homeAway` 'home' | 'away', required
    - `lineScores` integer[], required
    - `points` integer, required
    - `drives` integer, required
    - `scoringOpportunities` integer, required
    - `pointsPerOpportunity` number, double, required
    - `averageStartYardLine` number, double, nullable, required
    - `plays` integer, required
    - `lineYards` number, double, required
    - `lineYardsPerRush` number, double, required
    - `secondLevelYards` number, double, required
    - `secondLevelYardsPerRush` number, double, required
    - `openFieldYards` number, double, required
    - `openFieldYardsPerRush` number, double, required
    - `epaPerPlay` number, double, required
    - `totalEpa` number, double, required
    - `passingEpa` number, double, required
    - `epaPerPass` number, double, required
    - `rushingEpa` number, double, required
    - `epaPerRush` number, double, required
    - `successRate` number, double, required
    - `standardDownSuccessRate` number, double, required
    - `passingDownSuccessRate` number, double, required
    - `explosiveness` number, double, required
    - `deserveToWin` number, double — Deserve-to-win metric for this team
  - `drives` LiveGameDrive[], required
    - `id` string, required
    - `offenseId` integer, required
    - `offense` string, required
    - `defenseId` integer, required
    - `defense` string, required
    - `playCount` integer, required
    - `yards` integer, required
    - `startPeriod` integer, required
    - `startClock` string, nullable, required
    - `startYardsToGoal` integer, required
    - `endPeriod` integer, nullable, required
    - `endClock` string, nullable, required
    - `endYardsToGoal` integer, nullable, required
    - `duration` string, nullable, required
    - `scoringOpportunity` boolean, required
    - `result` string, required
    - `pointsGained` integer, required
    - `plays` LiveGamePlay[], required
      - `id` string, required
      - `homeScore` integer, required
      - `awayScore` integer, required
      - `period` integer, required
      - `clock` string, required
      - `wallClock` string, date-time, required
      - `teamId` integer, required
      - `team` string, required
      - `down` integer, required
      - `distance` integer, required
      - `yardsToGoal` integer, required
      - `yardsGained` integer, required
      - `playTypeId` integer, required
      - `playType` string, required
      - `epa` number, double, nullable, required
      - `garbageTime` boolean, required
      - `success` boolean, required
      - `rushPass` 'rush' | 'pass' | 'other', required
      - `downType` 'passing' | 'standard', required
      - `playText` string, required

---

[API](https://skmtc.net/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.net/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collegefootballdata/college-football-data-api/revisions/2753e757620d/schema)