Skip to main content
POST
Re-verify an identity from its stored verification

Authorizations

X-API-Key
string
header
required

Path Parameters

principal_ref
string
required

Response

Response

Body for the submission routes: the accepted, asynchronous submission.

KYC/KYB run asynchronously — the response never carries a verification result. Poll GET /identity_submissions/{submission_id} or subscribe to the OnboardingSession.completed webhook for the outcome and refs.

submission_id
string<uuid>
required

Unique id of the accepted submission — the handle for status polling, and the session id the OnboardingSession.completed webhook carries.

state
enum<string>
required

Lifecycle state of the verification workflow.

Available options:
PENDING,
EXECUTING,
WAITING,
COMPLETED,
FAILED,
EXPIRED,
CANCELLED
reference_id
string | null

Caller-supplied correlation id.