Verify a Receipt — POST /v1/receipts/:receipt_id/verify

Submit a verification verdict for an execution receipt. Supports manual and automated verifiers. Returns the updated VerificationRecord.

Submits a verification verdict for the specified receipt and returns the resulting VerificationRecord. Both human reviewers and automated verifiers use this endpoint.

Path Parameters

receipt_id · string (UUID) · required

The UUID of the execution receipt to verify.

Request Body

verifier_id · string · required

Identifier of the verifier submitting this verdict (e.g. "auditor-1" or "auto-verifier").

verdict · string · required

The verification outcome. One of not_required, pending, verified, or failed.

automated · boolean

Set to true when the verdict is produced by an automated system. Defaults to false.

reason · string

Optional human-readable explanation for the verdict, especially useful when verdict is failed.

Response

Returns a VerificationRecord object.

receipt_id · string (UUID) · required

The UUID of the receipt this verification applies to.

verifier_id · string · required

Identifier of the verifier that submitted this verdict.

verdict · string · required

The recorded verdict. One of not_required, pending, verified, or failed.

automated · boolean · required

Whether this verdict was produced by an automated verifier.

reason · string

Explanation provided by the verifier, if any.

verified_at · string (ISO 8601) · required

UTC timestamp when this verification record was created.

Errors

Status	Description
404	No receipt with the given receipt_id exists.

Example

curl -X POST http://your-node:8042/v1/receipts/018f4e2a-1c3b-7d90-a1b2-3c4d5e6f7890/verify \
  -H 'content-type: application/json' \
  -d '{
    "verifier_id": "auditor-1",
    "verdict": "verified"
  }'

Example response

{
  "receipt_id": "018f4e2a-1c3b-7d90-a1b2-3c4d5e6f7890",
  "verifier_id": "auditor-1",
  "verdict": "verified",
  "automated": false,
  "verified_at": "2025-01-15T11:00:00Z"
}