---
title: "List the calling agent's review-hold lifecycle"
method: GET
path: "/safe-house/reviews"
tags: ["Safe House"]
---

# List the calling agent's review-hold lifecycle

`GET /safe-house/reviews`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/safe-house/reviews`
- Auth: API key in header `X-Mnemom-Agent-Proof`

The reconcile/backfill ("pull, truth") leg of the Safe House review-hold lifecycle (Task A1, canonical-consumer plan) — the same shape delivered live via the `sh.review.*` webhook. Agent-scoped, not org/user-scoped: `agent_id` is always resolved from the caller's own possession proof (AgentAuth), never from a query parameter, so one agent can never read another's reviews.

## Query parameters

- `run_id` string
- `status` 'pending' | 'allowed' | 'denied' | 'expired'
- `since` string, date-time
- `limit` integer

## Response `200`

The agent's review-hold lifecycle rows, newest first.

- object
  - `reviews` ReviewLifecycle[], required
    - `review_id` string, required
    - `status` 'pending' | 'allowed' | 'denied' | 'expired', required
    - `surface` 'incoming' | 'tool_call' | 'tool_response', required
    - `verdict` string, required: The reconciled verdict on the ruling `safe_house_decisions` row.
    - `reason` string, nullable, required
    - `reviewer_model` string, nullable, required: Pinned reviewer model, e.g. `claude-opus-4-8`, when the review was adjudicated.
    - `triggered_at` string, date-time, nullable, required
    - `resolved_at` string, date-time, nullable, required
    - `turn_index` integer, nullable, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.

---

[API](https://skmtc.dev/mnemom/apis/mnemom-api.md) · [All operations](https://skmtc.dev/mnemom/apis/mnemom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mnemom/apis/mnemom-api/revisions/274b7a6ea182?raw)