Start a person's verification

POST/v1/kyb/cases/{id}/persons/{personId}/verification

Creates a verification session of the case's workflow for one person (a signatory or beneficial owner) and returns its url; with send_link the link goes out by email or SMS. Charged as a normal verification. At most 20 per case. Needs kyb:write.

Send your API key in the x-api-key header.

Path parameters

idstringuuidrequired
personIdstringuuidrequired

Request bodyapplication/json

emailstring
phonestring
E.164, e.g. +41791234567
send_linkany
One ofemailsms

Responses

201The verification: person_id, verification_id, url, link_sent.
404No such case or person.
409The person already has a verification, the case is closed, or the case reached 20 verifications.
422A legal person cannot verify itself, or send_link lacks its contact.

curl -X POST https://api-verify.secuveri.com/v1/kyb/cases/6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10/persons/6f1c2e0a-8f43-4f7e-9a51-2b7c1d9e4a10/verification \
  -H "x-api-key: $SECUVERI_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "email": "jane@example.com",
  "phone": "+41791234567",
  "send_link": "email"
}'