---
title: "Get Outcome Receipt status"
method: GET
path: "/api/v1/receipts/{receipt_id}/status"
---

# Get Outcome Receipt status

`GET /api/v1/receipts/{receipt_id}/status`

## Request

- Base URL: `https://spoolis.com`
- URL: `https://spoolis.com/api/v1/receipts/{receipt_id}/status`
- Auth: none required

Optional online correction, revocation, and advisory layer for an Outcome Receipt. The response includes state for coarse currentness and status for receipt disposition when the receipt is known. Offline signature verification proves authenticity without Spoolis uptime. A well-formed unseen receipt ID returns unknown with HTTP 200. Receipt IDs are content-derived 96-bit values, and the response contains no party identity or private amount data. No account or API key is required.

## Path parameters

- `receipt_id` string, required

## Response `200`

Receipt status

- ReceiptStatus
  - `receipt_id` string, required
  - `state` 'current' | 'superseded' | 'unknown', required
  - `status` 'active' | 'corrected' | 'revoked'
  - `advisories` string[]
  - `superseded_by` string
  - `superseding_reason` string
  - `consumptions_recorded` integer, nullable, required
  - `checked_at` string, date-time, required
  - `reviews` object, required
    - `pending` integer, required
  - `disputes` object, required
    - `open` integer, required

## Other responses

- `400`: Machine-readable API error
- `429`: Machine-readable API error

---

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