List finished verifications
/v1/verificationsNewest 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 of
COMPLETEFAILEDREVIEW_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 of
created_atcompleted_at
Responses
200One page of verifications.
- verificationsarray of VerificationSummary
Show 12 child propertiesHide 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"{
"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
}