Hanzo
OpenapiStanding

Reports what keeping this entity costs every year, itemised.

Reports what keeping this entity costs every year, itemised.

POST /v1/standing/upkeep

Addresshttps://api.hanzo.ai/v1/standing/upkeep
MethodPOST
Operationpost_standing_upkeep
AuthAuthorization: Bearer $HANZO_API_KEY

Reports what keeping this entity costs every year, itemised.

This is the figure that decides where to incorporate, and the one a formation price cannot show: Delaware is cheaper to form than Wyoming for a corporation and dearer to keep, so a founder shown only the formation fee is shown the half that reverses. Each state line carries the authority that publishes it and the date it was checked, and a franchise tax that scales is marked a minimum rather than quoted as final.

Request

3 fields, body application/json (required).

FieldInTypeRequiredDescription
agentOfRecordbodybooleanAgentOfRecord includes our agent fee, which most entities owe someone.
jurisdictionbodystringJurisdiction is the state the entity stands in.
structurebodystringStructure is the entity kind: c-corp, llc or dao-llc.

Response

StatusBodyMeaning
200Upkeepok

200 body — 15 fields.

FieldInTypeAlwaysDescription
atLeastbodybooleanAtLeast reports that some obligation is a minimum, so YearlyCents is a floor rather than a final figure.
currencybodystringCurrency is the ISO code every amount here is denominated in.
jurisdictionbodystringJurisdiction is the state whose obligations these are.
obligationsbodyObligation[]Obligations are the recurring charges, in the order a reader should see them.
obligations[].amountCentsbodyintegerAmountCents is what it costs each period.
obligations[].asOfbodystringAsOf is when that amount was last checked against its source, RFC 3339 date.
obligations[].codebodystringCode names the obligation so a caller can branch without reading prose.
obligations[].everybodystringEvery is how often it falls due — "yearly" for every obligation known here.
obligations[].labelbodystringLabel is what the payer sees.
obligations[].minimumbodybooleanMinimum marks a floor rather than a fixed price — a franchise tax that scales with shares or assets is quoted at its minimum, and an entity past the threshold…
obligations[].passThroughbodybooleanPassThrough marks money we collect and remit to the state rather than keep.
obligations[].sourcebodystringSource names the authority that publishes a pass-through amount, so the figure can be checked without first working out who would know.
obligations[].stalebodybooleanStale reports that AsOf is older than the review window.
structurebodystringStructure is the entity this prices.
yearlyCentsbodyintegerYearlyCents is what the entity owes every year, all obligations summed.

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Standing API · All Hanzo APIs · Interactive reference

How is this guide?

On this page