Run Automated Verifier Sweep — POST /v1/verifier/run

Trigger the automated verifier to process all pending execution receipts and record a VerificationRecord for each receipt in bulk.

Runs the automated verifier against every receipt whose verification field is pending, records a VerificationRecord for each, and returns the full list of records created by this sweep run.

Request Body

verifier_id · string · required

Identifier for the automated verifier performing this sweep (e.g. "auto-verifier"). This value is recorded on each VerificationRecord produced by the sweep.

Response

Returns { "items": [VerificationRecord] }.

items · array

Array of VerificationRecord objects created during this sweep. Empty if no receipts were pending verification.

Show VerificationRecord

receipt_id · string (UUID) · required

The UUID of the receipt that was verified.

verifier_id · string · required

The verifier identifier passed in the request.

verdict · string · required

The verdict assigned to this receipt. One of not_required, pending, verified, or failed.

automated · boolean · required

Always true for records created by a verifier sweep.

reason · string

Optional explanation, populated when the verifier flags a receipt as failed.

verified_at · string (ISO 8601) · required

UTC timestamp when this verification record was created.

Example

curl -X POST http://your-node:8042/v1/verifier/run \
  -H 'content-type: application/json' \
  -d '{"verifier_id": "auto-verifier"}'

Example response

{
  "items": [
    {
      "receipt_id": "018f4e2a-1c3b-7d90-a1b2-3c4d5e6f7890",
      "verifier_id": "auto-verifier",
      "verdict": "verified",
      "automated": true,
      "verified_at": "2025-01-15T11:00:00Z"
    },
    {
      "receipt_id": "018f4e2b-ffff-7d90-cccc-aabbccddeeff",
      "verifier_id": "auto-verifier",
      "verdict": "failed",
      "automated": true,
      "reason": "result_digest mismatch",
      "verified_at": "2025-01-15T11:00:01Z"
    }
  ]
}