GET
/
v1
/
kyc
/
status
/
:userId
curl https://api.zquenceeee.com/v1/kyc/status/usr_01HX3ZAB... \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "kycStatus": "complete",
  "userId": "usr_01HX3ZAB...",
  "tenantId": "tnt_01HX3Z8MQW...",
  "environmentId": "69f9b5fa0600ccbf9c677005",
  "environmentType": "live",
  "providerKycStatus": "approved",
  "submittedOn": "2026-04-22T10:34:00.000Z",
  "clientInformation": {
    "firstName": "Ada",
    "lastName": "Lovelace",
    "dob": "1815-12-10",
    "address": "27 Dorset Street, London",
    "country": "GB"
  }
}
Returns a simplified KYC status response with only the essential status fields and client information. Use this endpoint to quickly check a user’s verification progress without retrieving the full KYC record. Fetches the KYC record by user ID.

​
Path parameters

​
userId
string
required
The user ID to retrieve KYC status for.

​
Returns

​
kycStatus
string
Current KYC status — pending, in_progress, review, complete, or failed.
​
userId
string
The user ID associated with this KYC record.
​
tenantId
string
The tenant ID that owns this KYC record.
​
environmentId
string
The environment ID where this KYC verification occurred.
​
environmentType
string
Environment type — live or sandbox.
​
providerKycStatus
string
The Onfido provider’s verification status (if applicable).
​
submittedOn
string
ISO 8601 UTC timestamp when the user submitted their verification.
​
clientInformation
object
Full client information object provided during KYC setup, including fields like firstName, lastName, dob, address, country, etc.

​
Error codes

StatusMeaning
401Missing or invalid API key pair.
404KYC record not found or belongs to a different tenant.
curl https://api.zquenceeee.com/v1/kyc/status/usr_01HX3ZAB... \
  -H "x-api-key: $ZQUENCE_PUBLIC_KEY" \
  -H "x-api-secret: $ZQUENCE_SECRET_KEY"

{
  "kycStatus": "complete",
  "userId": "usr_01HX3ZAB...",
  "tenantId": "tnt_01HX3Z8MQW...",
  "environmentId": "69f9b5fa0600ccbf9c677005",
  "environmentType": "live",
  "providerKycStatus": "approved",
  "submittedOn": "2026-04-22T10:34:00.000Z",
  "clientInformation": {
    "firstName": "Ada",
    "lastName": "Lovelace",
    "dob": "1815-12-10",
    "address": "27 Dorset Street, London",
    "country": "GB"
  }
}