Retrieve a KYC record
Fetch the KYC record for a user.
GET
/
v1
/
kyc
/
:userId
curl https://api.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"
}
Path parameters
Returns
A KYC record object.curl https://api.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"
}
Previous
Update a KYC recordPatch a KYC record. Uses deep $set so sibling fields aren't overwritten.
Next
⌘I
curl https://api.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"
}