Skip to main content
GET
List verifications

Authorizations

X-API-Key
string
header
required

Your workspace public key (pk_test_… or pk_live_…).

X-HMAC-Signature
string
header
required

HMAC-SHA256 of the request, hex-encoded, keyed with the workspace secret key. See API authentication.

Query Parameters

status
string

Only verifications in one of these statuses, comma-separated: created, started, submitted, resubmission_requested, approved, declined, abandoned, expired, review. A verification waiting for a document is stored as started and listed as documents_required.

external_id
string

Only verifications created with this external_id (exact, case-sensitive match).

Maximum string length: 255
limit
integer
default:20

How many verifications to return, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

The next_cursor of the previous page. Send the same filters with it.

Response

A page of verifications, newest first. next_cursor is null on the last page.

data
object[]
required
next_cursor
string | null
required