Retrieve KYC record

GET

kyc

:userId

curl https://api.zquence.ai/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

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://api.zquence.ai/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"
}

curl https://api.zquence.ai/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"
}

Introduction

Tenant

Environments

Customers

Accounts

KYC

Document reviews

Source of funds

Files

Webhooks

Sync

Sanctions

Retrieve KYC record

Path parameters

Returns

​Path parameters

​Returns

Path parameters

Returns