Get a Receipt by ID — GET /v1/receipts/:receipt_id

Retrieve a single execution receipt by UUID. Returns the full StoredReceipt including the invocation output and cryptographic digests.

Fetches a single StoredReceipt by its UUID, including the invocation output and both the request and result digests.

Path Parameters

receipt_id · string (UUID) · required

The UUID of the execution receipt to retrieve.

Response

Returns a single StoredReceipt object.

receipt · object · required

The core ExecutionReceipt record.

Show ExecutionReceipt

receipt_id · string (UUID) · required

Unique identifier for this execution receipt.

agent_id · string · required

The agent that handled this invocation.

provider_id · string · required

The provider that owns the agent.

status · string · required

Invocation outcome. One of running, succeeded, failed, or rejected.

verification · string · required

Current verification verdict. One of not_required, pending, verified, or failed.

request_digest · string · required

SHA-256 digest of the serialised invocation request payload.

result_digest · string

SHA-256 digest of the invocation result. Present once the invocation completes.

started_at · string (ISO 8601) · required

UTC timestamp when the invocation started.

completed_at · string (ISO 8601)

UTC timestamp when the invocation finished. Absent while status is running.

cost_units · integer

Execution cost in protocol cost units, if reported by the agent.

output · object

Structured output returned by the agent. Omitted when the invocation produced no structured output.

stderr · string

Diagnostic text captured from the agent’s stderr stream, if any.

Errors

Status	Description
404	No receipt with the given receipt_id exists.

Example

curl http://your-node:8042/v1/receipts/018f4e2a-1c3b-7d90-a1b2-3c4d5e6f7890

Example response

{
  "receipt": {
    "receipt_id": "018f4e2a-1c3b-7d90-a1b2-3c4d5e6f7890",
    "agent_id": "stripe-agent",
    "provider_id": "acme-labs",
    "status": "succeeded",
    "verification": "pending",
    "request_digest": "sha256:a3f1e2b4c5d6...",
    "result_digest": "sha256:9b8c7d6e5f4a...",
    "started_at": "2025-01-15T10:30:00Z",
    "completed_at": "2025-01-15T10:30:02Z",
    "cost_units": 10
  },
  "output": {
    "payment_link": "https://buy.stripe.com/example"
  }
}