Skip to main content
POST
Advance the user application

Authorizations

Authorization
string
header
required

API key as Bearer token

Headers

Reap-Version
enum<string>
required

API version (YYYY-MM-DD)

Available options:
2025-02-14
Example:

"2025-02-14"

Idempotency-Key
string

Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).

Required string length: 1 - 255

Path Parameters

id
string<uuid>
required

User ID

Body

How to advance the KYC application. The accepted methods depend on the project KYC integration mode; each method is a distinct variant selected by the method field.

method
string
required
Allowed value: "MANAGED_KYC"

Response

Application state after advancing

status
enum<string>
required

Current KYC application status

Available options:
NOT_STARTED,
AWAITING_DOCUMENTS,
IN_REVIEW,
APPROVED,
REJECTED,
RETRY_REQUIRED
Example:

"NOT_STARTED"

nextAction
ProviderSdk · object
required

Action the client must take next, or null if none remains

provider
string
deprecated

Deprecated: use nextAction.provider. Populated only when nextAction.type is PROVIDER_SDK.

Allowed value: "sumsub"
Example:

"sumsub"

sdkToken
string
deprecated

Deprecated: use nextAction.sdkToken. Populated only when nextAction.type is PROVIDER_SDK.

Example:

"_act-sbx-abc123-xyz789"