Skip to main content
GET
/
api
/
v1
/
user
/
kyc
/
status
KYC status
curl --request GET \
  --url https://api.example.com/api/v1/user/kyc/status
Requires X-Api-Key, X-Api-Secret, and Authorization: Bearer <user-jwt> headers. The JWT identifies the user whose KYC status is returned.
Returns the current KYC verification status for the authenticated user. Use this endpoint to check whether a user has completed identity verification before allowing financial operations.

​
Request

GET /api/v1/user/kyc/status
No body or query parameters.

​
Response

200 OK 
{
  "success": true,
  "data": {
    "status": "approved",
    "rawStatus": "approved",
    "inquiryId": "inq_abc123xyz",
    "updatedAt": "2026-06-10T14:30:00.000Z"
  }
}
FieldTypeDescription
data.statusstringNormalized KYC status — see values below
data.rawStatusstringRaw status string from the KYC provider
data.inquiryIdstringPersona inquiry ID — use for support queries
data.updatedAtstringISO 8601 timestamp of the last status update

​
Status values

StatusDescriptionCan operate?
approvedIdentity verifiedYes
createdVerification session created, not yet startedNo
processingUnder automated reviewNo
manual_reviewEscalated for manual reviewNo
failedVerification rejectedNo

​
Errors

HTTP statusErrorCause
401Invalid or expired user tokenJWT missing or expired
403User does not belong to this partnerJWT issued by a different partner
404KYC not foundNo KYC verification has been initiated for this user — call POST /partner/kyc first