Initiate wallet KYC verification

POST

/v2/onboarding/wallet/initiate-kyc

• Staging
• Development

Initiate KYC verification for a wallet without requiring SIWE signature. This endpoint is for use when the user is already authenticated via session/API keys. Checks local cache and TRUST network first, then initiates KYC provider (Sumsub) if needed.

Authorizations

• X-API-Key
• X-API-Secret

Request Body ^required

object

walletAddress

required

Wallet address (normalized to lowercase with 0x prefix)

string

0x41abab3a4befc66569c5ccd9f4a687e141fa85b3

chainId

required

Chain ID of the blockchain network

number

84532

Responses

201

KYC initiation result with session URL if verification is required.

object

verificationId

Unique verification ID

string

82c4fce1-d2c7-48cb-a647-6993dbe37819

verified

required

Whether the wallet is verified

boolean

status

required

Verification status

string

Allowed values: verified not_verified pending

pending

walletAddress

required

Wallet address

string

0x41abab3a4befc66569c5ccd9f4a687e141fa85b3

chainId

required

Chain ID

number

84532

chain

Chain name

string

BASE_SEPOLIA

vaspId

VASP identifier if verified via TRUST

string

5493001KJTIIGC8Y1R12

vaspName

VASP name if verified via TRUST

string

Example VASP Inc

kycRequestId

KYC request ID if KYC provider verification initiated

string

550e8400-e29b-41d4-a716-446655440000

sessionUrl

Sumsub SDK session URL for identity verification

string

https://api.sumsub.com/websdk/init?token=...

message

Human-readable message about the verification status

string

KYC verification initiated. Please complete the verification process.

createdAt

Record creation timestamp

string

2025-11-27T04:18:07.173Z

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error