Get wallet KYC status with user PII details

GET

/v2/onboarding/wallet/details

• Staging
• Development

Retrieve the wallet KYC verification status along with decrypted user PII details from Aegis. Returns identity information (name, DOB, nationality), address, verified documents, verification scores, and screening results if available.

Authorizations

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

Parameters

Query Parameters

walletAddress

required

string

Wallet address to query

Example

0x41abab3a4befc66569c5ccd9f4a687e141fa85b3

chainId

required

number

Chain ID

Example

84532

Responses

201

The wallet KYC status including verification details, VASP information, and decrypted user PII from Aegis.

object

verificationId

required

Unique verification ID

string

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

verified

required

Whether the wallet has verified KYC

boolean

true

status

required

Verification status

string

Allowed values: verified not_verified pending invalid_signature invalid_message unsupported_chain trust_error

verified

walletAddress

required

Wallet address that was verified

string

0x41abab3a4befc66569c5ccd9f4a687e141fa85b3

chainId

required

Chain ID

number

84532

chain

Chain name

string

BASE_SEPOLIA

vaspId

VASP identifier (LEI) if wallet KYC is verified

string

5493001KJTIIGC8Y1R12

vaspName

VASP name if wallet KYC is verified

string

Example VASP Inc

vaspEndpoint

VASP PII endpoint if wallet KYC is verified

string

https://vasp.example.com/pii

errorMessage

Error message if verification failed

string

verifiedAt

Timestamp when verification was completed

string

2025-11-27T04:18:07.173Z

createdAt

required

Timestamp when record was created

string

2025-11-27T04:18:07.173Z

kycRequestId

KYC request ID if Sumsub verification was initiated

string

550e8400-e29b-41d4-a716-446655440000

sessionUrl

Sumsub SDK session URL for identity verification

string

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

message

Message from the verification service

string

KYC verification initiated. Please complete the verification process.

userDetails

Decrypted user PII from Aegis (if available)

object

identity

User identity information

object

firstName

First name

string

lastName

Last name

string

dateOfBirth

Date of birth

string

nationality

Nationality

string

verified

Whether identity was verified

boolean

confidence

Confidence score

number

address

User address information

object

street

Street address

string

city

City

string

state

State/Province

string

postalCode

Postal code

string

country

Country

string

verified

Whether address was verified

boolean

confidence

Confidence score

number

documents

Verified documents

Array<object>

object

verificationScore

Verification score (0-100)

number

confidenceLevel

Confidence level (0-100)

number

riskScore

Risk score (0-100)

number

screening

Screening results

object

sanctionsMatch

Sanctions match

boolean

pepMatch

Politically Exposed Person match

boolean

watchlistMatch

Watchlist match

boolean

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error