Skip to main content
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

StatusDescription
404No 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"
}