Hanzo
OpenapiTeam

Returns the plan and seat counts for the caller's OWN org, resolved from the…

Returns the plan and seat counts for the caller's OWN org, resolved from the VERIFIED team session token — never a client header.

GET /v1/team/billing/plan

Addresshttps://api.hanzo.ai/v1/team/billing/plan
MethodGET
Operationget_team_billing_plan
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the plan and seat counts for the caller's OWN org, resolved from the VERIFIED team session token — never a client header. Seats and guests are the org's distinct active human members (a bot member is not a seat); the plan comes from the licensing entitlement and is empty when that read is unavailable, so the page shows an honest dash rather than a fabricated tier. A caller with no verified session gets 401, and a real seat-read failure is a 502 rather than a false "0 members".

Request

GET /v1/team/billing/plan takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200planInfook

200 body — 6 fields.

FieldInTypeAlwaysDescription
activebodybooleanActive is whether that plan's entitlement is live.
guestLimitbodyintegerGuestLimit is the plan's team.guests cap, when the plan carries one.
guestsbodyintegerGuests is how many of those seats are guests.
planbodystringPlan is the licensed plan id, empty when it cannot be resolved here — an honest dash on the page, never a fabricated tier.
seatsbodyintegerSeats is the org's distinct active human members.
upgradeUrlbodystringUpgradeURL is where the page sends a caller who wants a bigger plan.

Failure carries the platform error shape — see Errors.

Examples

hanzo team billing plan

Team API · All Hanzo APIs · Interactive reference

How is this guide?

On this page