---
title: "Recover a recorded evaluation receipt after an ambiguous response"
method: GET
path: "/v1/protocol/evaluation-receipts"
---

# Recover a recorded evaluation receipt after an ambiguous response

`GET /v1/protocol/evaluation-receipts`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/protocol/evaluation-receipts`
- Auth: HTTP bearer

Read-only recovery for an authenticated protocol service identity and its
authorized organization. Ordinary organization and platform API keys are
rejected. Requires the service bearer token and X-Org-ID header. Does not
evaluate an action or return request, customer, or decision payloads.
The mode is the original persisted effective response mode, corroborated
by the evaluation row. Missing, unknown, or conflicting mode evidence
returns null; it is never inferred from requested mode or current workspace
settings. Consumers must not treat null, SHADOW, or PARALLEL as paid
enforcement. A not_found receipt is not evidence of a completed evaluation.

## Query parameters

- `idempotency_key` string, required
- `org_id` string, uuid

## Headers

- `X-Org-ID` string, uuid, required

## Response `200`

Opaque receipt and nullable recorded effective mode; private and not cacheable

- union
  - object
    - `status` 'recorded', required
    - `evaluation_id` string, uuid, required
    - `mode` 'SHADOW' | 'PARALLEL' | 'ENFORCEMENT' | 'null', nullable, required: Persisted effective mode, or null when historical evidence is absent or inconsistent.
  - object
    - `status` 'not_found', required
    - `evaluation_id` unknown, required
    - `mode` unknown, required

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `403`: Structured API error
- `503`: Receipt store unavailable; no inference about completion or mode is safe

---

[API](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-policy-evaluation-api/revisions/357f5e459d0c?raw)