Complete the verification submission

Close the editable submission and send its immutable snapshot for compliance review. This is the only operation that starts review. It is refused with kyb_incomplete and the same missing paths returned by GET when applicant information or documents are outstanding. An identical retry replays the existing application instead of creating a second review.

POST /client/kyb/complete

Complete the verification submission

cURL

curl --request POST \
  --url https://api.example.com/client/kyb/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Hevn-Account: <x-hevn-account>'

201

{
  "applicationId": "kyb_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41",
  "status": "notStarted",
  "attemptNo": 123,
  "pollUrl": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Hevn-Account · string · required

The selected client account, as a cl_… id.

Example:

"cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"

x-api-key · string | null

Idempotency-Key · string | null

Your own key for this write, ^[A-Za-z0-9._:-]{1,128}$. A retry with the same key replays the first answer; the same key with a different request is refused.

Example:

"po-inv-2026-114"

Response

201

application/json

Successful Response

applicationId · string · required

Immutable verification application identifier.

Pattern: ^(?:kyb_)?[A-Za-z0-9._:\-]{1,216}$

Example:

"kyb_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"

status · enum<string> · required

Current public review status.

Available options: notStarted, pending, approved, rfi, rejected

attemptNo · integer · required

One-based submission attempt number for this account.

pollUrl · string · required

Relative API URL to poll for the latest review state.