> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voicemark.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /receipt

> Log an audit event tied to a token.

Logs an audit event tied to a verify token. No PII is stored — the `token_id` provides accountability without identifying the speaker.

## Request

`POST /v1/receipt`

**Content-Type:** `application/json`

| Field | Type | Required | Notes |
| - | - | - | - |
| `token` | string | Yes | Full JWT from `/v1/verify` |
| `action` | string | Yes | Namespaced action identifier |
| `result` | string | Yes | `"success"` or `"failure"` |
| `metadata` | object | No | Arbitrary key-value pairs (no PII) |

## Response

```json theme={null}
{
  "receipt_id": "rec_1a2b3c4d5e6f",
  "logged_at": "2026-11-09T14:35:12Z"
}
```

## Example

```typescript theme={null}
await vm.receipt(
  verify.token,
  "payment.authorise",
  "success",
  { amount: 250.00, currency: "GBP" }
);
```

> [!NOTE]
>
> Receipts are keyed by `token_id`, which is anonymous. Do not include names, email addresses, or other personal data in `metadata`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.