---
title: "Get Game Quarter Summary"
method: GET
path: "/api/v1/games/{game_id}/quarter_summary"
tags: ["Games"]
---

# Get Game Quarter Summary

`GET /api/v1/games/{game_id}/quarter_summary`

Get per-quarter team statistics for a single game.

Returns the same shape as `/summary` but split by quarter, ordered by quarter.

Requires League header and x-api-key header.

Args:
    game_id: The game identifier (UUID string, matches game_info.video_id)
    conn: Database connection (injected)

Returns:
    GameQuarterSummaryResponse with game_id and a list of per-quarter team stats

## Path parameters

- `game_id` string, required

## Headers

- `x-api-key` string, required — Required API key issued by Preciser.
- `League` string, required — Required tenant/database selector, for example pitchbio-master.

## Response `200`

Successful Response

- GameQuarterSummaryResponse — Response schema for per-quarter game summary endpoint.
  - `game_id` string, required — Game identifier
  - `competition_id` string, nullable — Stable league/competition identifier for the game
  - `quarters` GameQuarterStats[], required — Per-quarter team statistics, ordered by quarter
    - `quarter` string, required — Quarter identifier (e.g., 'Q1', 'Q2', 'OT1')
    - `home_team` TeamGameStats, required — Team statistics for a single game.
      - `team_id` string, required — Team identifier
      - `score` integer, required — Total points scored
      - `rebound` integer, required — Total rebounds
      - `offensive_rebound` integer, required — Offensive rebounds
      - `defensive_rebound` integer, required — Defensive rebounds
      - `assist` integer, required — Total assists
      - `steal` integer, required — Total steals
      - `block` integer, required — Total blocks
      - `turnover` integer, required — Total turnovers
      - `pf` integer, required — Personal fouls
      - `two_points_made` integer, required — Two-pointers made
      - `two_points_attempt` integer, required — Two-pointers attempted
      - `two_points_percentage` number, required — Two-point field goal percentage
      - `three_points_made` integer, required — Three-pointers made
      - `three_points_attempt` integer, required — Three-pointers attempted
      - `three_points_percentage` number, required — Three-point field goal percentage
      - `free_throw_made` integer, required — Free throws made
      - `free_throw_attempt` integer, required — Free throws attempted
      - `free_throw_percentage` number, required — Free throw percentage
      - `seconds` integer, nullable — Total seconds played
    - `away_team` TeamGameStats, required — Team statistics for a single game.
      - `team_id` string, required — Team identifier
      - `score` integer, required — Total points scored
      - `rebound` integer, required — Total rebounds
      - `offensive_rebound` integer, required — Offensive rebounds
      - `defensive_rebound` integer, required — Defensive rebounds
      - `assist` integer, required — Total assists
      - `steal` integer, required — Total steals
      - `block` integer, required — Total blocks
      - `turnover` integer, required — Total turnovers
      - `pf` integer, required — Personal fouls
      - `two_points_made` integer, required — Two-pointers made
      - `two_points_attempt` integer, required — Two-pointers attempted
      - `two_points_percentage` number, required — Two-point field goal percentage
      - `three_points_made` integer, required — Three-pointers made
      - `three_points_attempt` integer, required — Three-pointers attempted
      - `three_points_percentage` number, required — Three-point field goal percentage
      - `free_throw_made` integer, required — Free throws made
      - `free_throw_attempt` integer, required — Free throws attempted
      - `free_throw_percentage` number, required — Free throw percentage
      - `seconds` integer, nullable — Total seconds played

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-27** `9b0abde08b06` — 4 breaking, 2 info
  - the `header` request parameter `League` became required
  - the `header` request parameter `x-api-key` became required
  - `header` request parameter `League` list-of-types was narrowed by removing types `null`
  - `header` request parameter `x-api-key` list-of-types was narrowed by removing types `null`
  - …2 more
- **2026-08-17** `64853d21435b` — 1 info
  - added the optional property `competition_id` to the response with the `200` status

[Change history](https://skmtc.dev/preciser/apis/preciser-data-management-api/changes/api/v1/games/:game_id/quarter_summary/get.md)

---

[API](https://skmtc.dev/preciser/apis/preciser-data-management-api.md) · [All operations](https://skmtc.dev/preciser/apis/preciser-data-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/preciser/preciser-data-management-api/revisions/9b0abde08b06/schema)