---
title: "Get Wave Summary Endpoint"
method: GET
path: "/projects/{project_id}/wave-summary/{wave_id}"
---

# Get Wave Summary Endpoint

`GET /projects/{project_id}/wave-summary/{wave_id}`

## Request

- Base URL: `https://usemeridian.us` (the document declares no server; this is the origin it was published from)
- URL: `https://usemeridian.us/projects/{project_id}/wave-summary/{wave_id}`
- Auth: none declared

bbb447ec — the authoritative, immutable completion record for one wave.

REST mirror of ``meridian.db.get_wave_summary`` — a read-only projection
of a wave's persisted completion summary (item outcomes, commits/changed
resources, test receipts, blockers, exclusions, tool availability,
handoff status), keyed by ``wave_id`` (the same value as
``sprint_items.wave`` / ``wave_gate_results.wave_label``, e.g.
``"wave-5"``). Optional ``?version=`` query param scopes to one
sprint-version bucket (unscoped/'' bucket by default — same convention as
``board_snapshot_revisions``); optional ``?wave_run_id=`` narrows to one
specific run/attempt. Pass ``?include_history=1`` to also return every
prior (superseded) row in the correction chain, oldest first — the full
audit trail, mirroring ``get_wave_run_events(include_superseded=True)``.

``{"summary": null}`` (never a 404) when no summary has ever been
recorded for the bucket — a wave with no summary yet is a normal state,
not an error, matching ``load_handoff_correction``'s own "null body, not
404" convention just above.

## Path parameters

- `project_id` string, required
- `wave_id` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usemeridian/apis/meridian.md) · [All operations](https://skmtc.dev/usemeridian/apis/meridian/llms.txt) · [OpenAPI document](https://skmtc.dev/usemeridian/apis/meridian/revisions/f37a894bd374?raw)