Skip to main content
GET
Poll a submission's verification status

Authorizations

X-API-Key
string
header
required

Path Parameters

submission_id
string<uuid>
required

Response

Response

Body for GET /identity_submissions/{submission_id} and the payload of the OnboardingSession.completed webhook.

Pairwise refs appear once verification completes successfully; they are the durable handles for the identity status route and credential minting. Global ids are never exposed.

submission_id
string<uuid>
required

Unique id of the submission.

state
enum<string>
required

Lifecycle state of the verification workflow.

Available options:
PENDING,
EXECUTING,
WAITING,
COMPLETED,
FAILED,
EXPIRED,
CANCELLED
verdict
enum<string> | null

Resolved onboarding verdict; null until completion.

Available options:
APPROVED,
UNDER_REVIEW,
REJECTED
reference_id
string | null

Caller-supplied correlation id.

completed_at
string<date-time> | null

When the workflow reached a terminal state.

principal_ref
string | null

Pairwise reference to the verified principal, unique to the calling organization and stable across re-verification.

business_ref
string | null

Pairwise reference to the verified business, when the submission covered one.

Status of the principal-operates-business link as of this submission's evaluation.

Available options:
VERIFIED,
UNDER_REVIEW,
REJECTED