Skip to main content
WEBHOOK

Body

application/json
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
__event__
WebhookMetadata · object
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

Response

Successful Response