List Execution Receipts — GET /v1/receipts Endpoint

Query execution receipts by agent_id, provider_id, or verification verdict. Returns StoredReceipt objects with digests and invocation status.

Returns a list of StoredReceipt objects, optionally filtered by agent, provider, or verification verdict.

Query Parameters

agent_id · string

Filter receipts to those produced by this agent.

provider_id · string

Filter receipts to those produced under this provider.

verification · string

Filter by verification verdict. One of not_required, pending, verified, or failed.

limit · integer

Maximum number of receipts to return.

Response

Returns { "items": [StoredReceipt] }.

items · array

Array of StoredReceipt objects.

Show StoredReceipt

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.

Examples

List receipts for a provider

curl 'http://your-node:8042/v1/receipts?provider_id=acme-labs'

List receipts for a specific agent

curl 'http://your-node:8042/v1/receipts?agent_id=stripe-agent'

Filter by verification verdict

curl 'http://your-node:8042/v1/receipts?verification=pending&limit=20'

Example response

{
  "items": [
    {
      "receipt": {
        "receipt_id": "018f4e2a-1c3b-7d90-a1b2-3c4d5e6f7890",
        "agent_id": "stripe-agent",
        "provider_id": "acme-labs",
        "status": "succeeded",
        "verification": "verified",
        "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"
      },
      "stderr": "agent: retried once on connection reset"
    }
  ]
}