Hanzo
OpenapiCompany

Returns the platform's whole formation register, newest activity first — every…

Returns the platform's whole formation register, newest activity first — every org's formation, not the caller's.

GET /v1/company/register

Addresshttps://api.hanzo.ai/v1/company/register
MethodGET
Operationget_company_register
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the platform's whole formation register, newest activity first — every org's formation, not the caller's. It is a Hanzo platform operation: a caller who is not a platform reviewer gets 403.

Filter by stage and structure, page with limit and offset. An unknown stage is refused with 400 rather than returning a silently empty page.

Request

4 fields.

FieldInTypeRequiredDescription
stagequerystringStage keeps only formations at that stage.
structurequerystringStructure keeps only formations of that entity kind.
limitqueryintegerLimit bounds the page; 0 or less means the default of 200.
offsetqueryintegerOffset skips that many rows.

Response

StatusBodyMeaning
200registerPageok

200 body — 10 fields.

FieldInTypeAlwaysDescription
countbodyintegerCount is how many rows this page holds.
formationsbodyRegistration[]Formations are the rows, newest activity first.
formations[].createdAtbodyintegerCreatedAt is the unix second the formation was opened.
formations[].namebodystringName is the company name the entity is being formed under.
formations[].orgbodystringOrg is the org whose formation this row projects.
formations[].stagebodystringStage is the formation's current state — what the platform reads to see which formations are stalled and where.
formations[].structurebodystringStructure is the legal entity being formed: c-corp, llc or dao-llc.
formations[].updatedAtbodyintegerUpdatedAt is the unix second of the most recent write to the formation, and the key the register sorts on (newest activity first).
limitbodyintegerLimit is the page size that was applied.
offsetbodyintegerOffset is the offset that was applied.

Failure carries the platform error shape — see Errors.

Examples

hanzo company register get

Company API · All Hanzo APIs · Interactive reference

How is this guide?

On this page