Hanzo
OpenapiCompany

Reports the founders whose KYC is not yet settled, oldest formation first, so…

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