Skip to main content
GET
/
widget
/
users
/
{partner_user_id}
/
kyc-status
GET /widget/users/{id}/kyc-status
curl --request GET \
  --url https://domain/widget/users/{partner_user_id}/kyc-status \
  --header 'Authorization: <authorization>'
{
  "partner_user_id": "<string>",
  "status": "<string>",
  "verified_at": "<string>"
}

​
Path Parameters

​
partner_user_id
string
required
Your internal user identifier.

​
Request Headers

​
Authorization
string
required
Bearer token. Format: Bearer <client_token>

​
Response

​
partner_user_id
string
Your internal user identifier.
​
status
string
KYC status. See table below.
​
verified_at
string
ISO 8601 timestamp of when KYC was verified. Present only when status is verified.

​
KYC Statuses

StatusDescription
not_startedUser has never opened the widget or submitted KYC
pendingKYC submitted, under review
verifiedKYC passed — user can transact
failedVerification failed — user must retry inside the widget

​
Examples

curl https://DOMAIN/widget/users/user-123/kyc-status \
  -H "Authorization: Bearer <client_token>"
Response
{
  "partner_user_id": "user-123",
  "status": "verified",
  "verified_at": "2026-03-15T10:00:00Z"
}