Hanzo
OpenapiEntitlement

Projection reports which console apps the CALLER's org may open, and the plan…

Projection reports which console apps the CALLER's org may open, and the plan slug that decides it.

GET /v1/entitlement

Addresshttps://api.hanzo.ai/v1/entitlement
MethodGET
Operationget_entitlement
AuthAuthorization: Bearer $HANZO_API_KEY

Projection reports which console apps the CALLER's org may open, and the plan slug that decides it. It is the READ side of the unified paywall: the org's plan tier resolved from commerce, which is a different authority from the enablement store behind GET /v1/entitlement/orgs/{org} (that one is the org's own on/off intent).

It fails SAFE-TO-LOCKED, never 500: an unvalidated principal is a 403, but a commerce outage reports every app locked at 200 rather than breaking the shell. The ENFORCEMENT path still fails open, so functionality survives the same outage even while the UI conservatively shows locked.

Request

GET /v1/entitlement takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200projectionViewok

200 body — 3 fields.

FieldInTypeAlwaysDescription
appsbodyobjectApps says, per console app, whether the org may open it.
apps.*bodyboolean
tierbodystringTier is the plan slug commerce resolved for the org, or "" when the org has no active licensing subscription — which the console treats as its free default.

Failure carries the platform error shape — see Errors.

Examples

hanzo entitlements get

Entitlement API · All Hanzo APIs · Interactive reference

How is this guide?

On this page