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
decision
enum<string>
required

Manual decision applied to the session.

Available options:
APPROVED,
REJECTED
__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
reason
string | null

Reviewer-supplied decision reason, when given.

decided_at
string<date-time> | null

When the decision was recorded.

findings
OnboardingFinding · object[]

The session's materialized findings, frozen at packet delivery — the open findings this decision resolved.

Response

Successful Response