GET
/
v1
/
kyc
/
:userId
curl https://v2.app-dev.zquence.com/v1/kyc/usr_01HX3ZAB... \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "kyc_01HX3ZH...",
  "userId": "usr_01HX3ZAB...",
  "tenantId": "tnt_01HX3Z8MQW...",
  "status": "complete",
  "currentStep": 54,
  "result": {
    "identity": "clear",
    "document": "clear",
    "liveness": "clear"
  },
  "submittedOn": "2026-04-22T10:34:00.000Z",
  "createdAt": "2026-04-22T10:25:00.000Z"
}
Requires kyc.read.

​
Path parameters

​
userId
string
required

​
Returns

A KYC record object. If account onboarding created a pending record before provider verification started, this endpoint returns that record without requiring a provider workflow. It returns 404 when KYC has not started for the user. 
curl https://v2.app-dev.zquence.com/v1/kyc/usr_01HX3ZAB... \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "id": "kyc_01HX3ZH...",
  "userId": "usr_01HX3ZAB...",
  "tenantId": "tnt_01HX3Z8MQW...",
  "status": "complete",
  "currentStep": 54,
  "result": {
    "identity": "clear",
    "document": "clear",
    "liveness": "clear"
  },
  "submittedOn": "2026-04-22T10:34:00.000Z",
  "createdAt": "2026-04-22T10:25:00.000Z"
}