List finished verifications

GET/v1/verifications

Newest first (by created_at, or by completed_at with order=completed_at), as plain JSON: ids, status, verdict, reason and times, no personal data. Only verifications of the key's environment, and for a key issued through Connect with secuveri only the sessions it created, unless its connection includes the results:read-all setup right. Rely on the signed result (GET /v1/verifications/{id}/result) for decisions. Needs the results:read scope. At most 300 calls per minute per organization.

Send your API key in the x-api-key header.

Query parameters

  • statusstring

    One ofCOMPLETEFAILEDREVIEW_REQUIREDCHECK_ERROREXPIRED

  • vendor_datastring≤ 255 chars
  • limitinteger1–100default 25
  • starting_afterstring

    A verification_id from the previous page; returns the ones after it in the chosen order.

  • orderstringdefault "created_at"

    created_at: newest started first. completed_at: newest finished first, leaving out verifications that never finished (expired); use it to poll for new results, since a verification can finish long after it started.

    One ofcreated_atcompleted_at

Responses

  • 200One page of verifications.
    • verificationsarray of VerificationSummary
      Show 12 child properties
      • verification_idstring
      • session_idstringuuid
      • workflow_idstring
      • vendor_datastring
      • metadataobject
      • statusstring
      • verdictstring
      • outcome_reasonstring
      • environmentstring
      • sandboxboolean
      • created_atstringdate-time
      • completed_atstringdate-time
    • has_moreboolean
  • 400Invalid filter, unknown starting_after, or a starting_after without completed_at under order=completed_at.
  • 401Missing, unknown or expired API key.
  • 403The key lacks the scope this call needs, or its IP allowlist refuses the caller.
  • 429More than 300 calls in a minute.
curl https://api-verify.secuveri.com/v1/verifications \
  -H "x-api-key: $SECUVERI_API_KEY"
Response · 200
{
  "verifications": [
    {
      "verification_id": "VRF-7KQ2M9XA",
      "session_id": "6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10",
      "workflow_id": "<published workflow id>",
      "vendor_data": "customer-1042",
      "metadata": {},
      "status": "COMPLETE",
      "verdict": "APPROVED",
      "outcome_reason": "<outcome reason>",
      "environment": "<environment>",
      "sandbox": true,
      "created_at": "2026-10-23T09:12:44.120Z",
      "completed_at": "2026-10-23T09:12:44.120Z"
    }
  ],
  "has_more": true
}