---
title: "Record Outcome Receipt consumption"
method: POST
path: "/api/v1/receipts/{receipt_id}/consumptions"
---

# Record Outcome Receipt consumption

`POST /api/v1/receipts/{receipt_id}/consumptions`

## Request

- Base URL: `https://spoolis.com`
- URL: `https://spoolis.com/api/v1/receipts/{receipt_id}/consumptions`
- Auth: HTTP bearer

Records how an authenticated consumer used a valid Outcome Receipt. An optional policy is recorded as an unevaluated string for audit context.

## Path parameters

- `receipt_id` string, required

## Request body

- ReceiptConsumptionRequest
  - `consumer_id` string, required
  - `action` string, required
  - `policy` union
    - string
    - object: The serialized object must not exceed 500 characters.

## Response `201`

Recorded receipt consumption event

- ReceiptConsumptionResponse
  - `consumption` ReceiptConsumptionEvent, required
    - `receipt_id` string, required
    - `environment` 'production' | 'demo', required
    - `consumer_id` string, required
    - `action` string, required
    - `policy` string, nullable
    - `consumed_at` string, date-time, required

## Other responses

- `400`: Machine-readable API error
- `401`: Machine-readable API error
- `404`: 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)