Start / retry a person's KYC
Creates a fresh KYC verification for the addressed person (personId, taken from the persons[] list in GET state — today the case representative) and points the case at it as the current attempt. Returns verification_url_id, which the widget renders as a QR/link for that person to complete KYC on mobile, plus the initial status to poll. Calling again while pending/passed returns the existing verification (200); after a failed/expired one it mints a new verification (201) — this is the “Try again” action. Uses the organization’s default verification profile, unless an optional profile_id is sent in the body to override it (temporary). Authenticated solely by the public_id in the path.
Path Parameters
KYB case public id.
KYC subject id (PersonKyc.person_id from GET state).
Body
Request body for kyb.PersonKycRequest
PersonKycRequest schema
"0195c1f0-1234-7000-8000-0123456789ab"
Response
Existing KYC verification returned (already pending/passed).
PersonKyc schema
"John Smith"
"0195c1f0-1234-7000-8000-0123456789ab"
"representative"
"not_started"
"0195c1f0-1234-7000-8000-0123456789ab"
"verified"
"https://verify.dataspike.io/vAbC0123456789"
"vAbC0123456789"