> ## Documentation Index
> Fetch the complete documentation index at: https://hs-df36fa00.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField body="verifier_id" type="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.
</ParamField>

## Response

Returns `{ "items": [VerificationRecord] }`.

<ResponseField name="items" type="array">
  Array of `VerificationRecord` objects created during this sweep. Empty if no receipts were pending verification.

  <Expandable title="VerificationRecord">
    <ResponseField name="receipt_id" type="string (UUID)" required>
      The UUID of the receipt that was verified.
    </ResponseField>

    <ResponseField name="verifier_id" type="string" required>
      The verifier identifier passed in the request.
    </ResponseField>

    <ResponseField name="verdict" type="string" required>
      The verdict assigned to this receipt. One of `not_required`, `pending`, `verified`, or `failed`.
    </ResponseField>

    <ResponseField name="automated" type="boolean" required>
      Always `true` for records created by a verifier sweep.
    </ResponseField>

    <ResponseField name="reason" type="string">
      Optional explanation, populated when the verifier flags a receipt as `failed`.
    </ResponseField>

    <ResponseField name="verified_at" type="string (ISO 8601)" required>
      UTC timestamp when this verification record was created.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

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

### Example response

```json theme={null}
{
  "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"
    }
  ]
}
```