Skip to main content
GET
Retrieve user verification

Authorizations

Authorization
string
header
required

Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx

Path Parameters

user_id
string
required
verification_id
string
required

Response

200 - application/json
user_id
string<uuid>
required

ID of the user entity created or verified

Example:

"550e8400-e29b-41d4-a716-446655440000"

verification_id
string<uuid>
required

Unique verification ID

Example:

"660f9511-f30c-52e5-b827-557766551111"

status
enum<string>
required

Current status of the verification. User verification is synchronous: a successful call returns completed. failed is reachable only via the test-mode _simulate: fail directive. in_progress and pending never occur for user verification — a temporarily unavailable provider returns a retryable 503 instead.

Available options:
completed,
failed
Example:

"completed"

mode
enum<string>
required

Test/live partition the verification was created under. Determined by the API key used.

Available options:
test,
live
Example:

"live"

risk
object
required

Risk assessment with level and detailed reasons

match
object
required

Field-level match results (only fields included in verification request)

created_at
string<date-time>
required

ISO 8601 timestamp of when the verification was created

Example:

"2025-10-24T10:30:00Z"

reference_id
string

Your reference ID (if provided in request)

Example:

"user_12345"

synthetic
object

Synthetic identity detection results

watchlist
object

Watchlist screening results (sanctions, PEP, adverse media)

updated_at
string<date-time>

ISO 8601 timestamp of when the verification was last updated

Example:

"2025-10-24T10:35:00Z"