---
title: "Get evaluation retirement"
method: GET
path: "/v0/admin/subscriptions/evaluation-retirements/{retirement_id}"
tags: ["Admin"]
---

# Get evaluation retirement

`GET /v0/admin/subscriptions/evaluation-retirements/{retirement_id}`

## Request

- Base URL: `https://docs.quivr.thevibecompany.co` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.quivr.thevibecompany.co/v0/admin/subscriptions/evaluation-retirements/{retirement_id}`
- Auth: HTTP bearer

Read the immutable audit receipt referenced by an evaluation.retired event or the retirement action's Location. Requires plugins:admin and grants covering the original request's entire Corpus scope; a deployment-wide request requires a key granting all Corpora. Unknown, another Organization's and ungranted receipts all answer 404 not_found.

## Path parameters

- `retirement_id` string, required

## Response `200`

The committed receipt

- EvaluationRetirement
  - `key` string, required
  - `plugin_id` string, required
  - `version` string, required
  - `reason` string, required
  - `dry_run` boolean, required
  - `limit` integer, required
  - `retirement_id` string, required
  - `created_at` string, date-time
  - `outcome` 'evaluator_retired', required
  - `items` RetiredEvaluation[], required
    - `subscription_id` string, required
    - `subscription_version_id` string, required
    - `sequence` integer, required: The original trigger's Organization journal position.
    - `corpus_id` string, required
    - `record_id` string, required
    - `record_version_id` string, required
    - `event_id` string: The evaluation.retired event; absent for a dry run.
  - `remaining` integer, required: Unavailable pending evaluations remaining in this request's scope, including leased ones.
  - `leased` integer, required: Unavailable pending evaluations skipped because their leases have not expired.

## Other responses

- `default`: Structured error; 401 unauthenticated, 403 without plugins:admin, 404 not_found, 503 storage unavailable.

---

[API](https://skmtc.dev/thevibecompany/apis/quivr-http-api.md) - [All operations](https://skmtc.dev/thevibecompany/apis/quivr-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thevibecompany/apis/quivr-http-api/revisions/4f4e30ba8f4e?raw)