Hanzo AI
OpenapiCompany

List review

Reports the founders whose KYC is not yet settled, oldest formation first, so the queue drains in the order founders have been waiting.

GET /v1/company/review

Addresshttps://api.hanzo.ai/v1/company/review
MethodGET
Operationget_company_review
AuthAuthorization: Bearer $HANZO_API_KEY

Reports the founders whose KYC is not yet settled, oldest formation first, so the queue drains in the order founders have been waiting. A Hanzo platform operation: a caller who is not a platform reviewer gets 403.

It only says who is waiting; the decision itself is POST /v1/company/kyc/decision.

Request

1 field.

FieldInTypeRequiredDescription
limitqueryintegerLimit bounds how many formations are scanned; 0 or less means the default of 200.

Response

StatusBodyMeaning
200reviewQueueok

200 body — 9 fields.

FieldInTypeAlwaysDescription
countbodyintegerCount is how many founders are waiting.
queuebodywaiting[]Queue is one entry per unsettled founder, oldest formation first.
queue[].emailbodystringEmail is the founder's email — the key a decision is posted against.
queue[].founderbodystringFounder is the founder's name.
queue[].kycRefbodystringKYCRef is the identity-verification session reference, when one was opened.
queue[].kycStatusbodystringKYCStatus is the founder's unsettled status.
queue[].namebodystringName is the proposed company name.
queue[].orgbodystringOrg is the tenant whose formation the founder belongs to.
queue[].sincebodyintegerSince is when the formation was last touched, as a unix second.

Failure carries the platform error shape — see Errors.

Examples

hanzo company review

Company API · All Hanzo APIs · Interactive reference

How is this guide?

On this page