Hanzo
OpenapiCompliance

Returns the org's KYC/KYB verifications, newest first — opaque subject…

Returns the org's KYC/KYB verifications, newest first — opaque subject references and provider-reported statuses only, no subject PII.

GET /v1/compliance/verifications

Addresshttps://api.hanzo.ai/v1/compliance/verifications
MethodGET
Operationget_compliance_verifications
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the org's KYC/KYB verifications, newest first — opaque subject references and provider-reported statuses only, no subject PII.

Request

1 field.

FieldInTypeRequiredDescription
limitqueryintegerLimit caps the rows returned; non-positive means the server default.

Response

StatusBodyMeaning
200checkListok

200 body — 12 fields.

FieldInTypeAlwaysDescription
databodycheckView[]Data is the org's verifications, newest first, without subject PII.
data[].createdAtbodyintegerCreatedAt is the unix second the verification was started.
data[].decidedAtbodyintegerDecidedAt is the unix second a terminal status was recorded.
data[].decidedBybodystringDecidedBy records who settled a terminal status: the provider name, or a reviewer's user id for a recorded manual decision.
data[].idbodystringID is the verification's opaque id.
data[].kindbodystringKind is the party type: "individual" (KYC) or "business" (KYB).
data[].providerbodystringProvider is the verification provider this check runs through.
data[].statusbodystringStatus is the check's state: pending, provider_verified, provider_rejected, manual_review, or expired (provider-reported), or reviewer_confirmed — the one…
data[].subjectIdbodystringSubjectID is the opaque id of the subject under verification.
data[].updatedAtbodyintegerUpdatedAt is the unix second the verification last changed.
data[].verifyUrlbodystringVerifyURL is the provider's hosted verification flow for the subject, when one exists.
disclaimerbodystringDisclaimer states that statuses are provider-reported, never a platform assertion of legal or regulatory compliance.

Failure carries the platform error shape — see Errors.

Examples

hanzo compliance verifications list

Compliance API · All Hanzo APIs · Interactive reference

How is this guide?

On this page