Skip to main content
POST
Revoke receipt
Revokes a receipt event. Sets the status to revoked and records a RECEIPT_REVOKE event in the transparency log. Only active receipts can be revoked.

Path parameters

string
required
UUID of the receipt to revoke.

Headers

string
required
UUID for idempotent revocation. Prevents duplicate revocation events.

Response

string
UUID of the revoked receipt.
string
revoked
string
ISO 8601 timestamp of revocation.

Webhook event

A receipt.revoked webhook event is delivered after successful revocation:
Revocation is permanent and recorded in the transparency log.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

id
string
required

Receipt UUID

Body

application/json
reason
string
required

Revocation reason

Response

Receipt revoked

receipt_id
string
status
string
revoked_at
string