Plans
Plan catalog + entitlement resolution
Plan catalog + entitlement resolution
| Base URL | https://api.hanzo.ai |
| Operations | 20 |
| Auth | Authorization: Bearer $HANZO_API_KEY |
plans
ListBlockchainPlans returns the blockchain RPC plan catalog: the tiers metered in monthly compute units, with their prices, limits and overage terms.
GET /v1/plans/blockchain
ListBlockchainPlans returns the blockchain RPC plan catalog: the tiers metered in monthly compute units, with their prices, limits and overage terms. It is the canonical catalog for every caller — these plans carry no reseller overrides.
ListCloudCapacityPlans returns the cloud plan catalog.
GET /v1/plans/cloud
ListCloudCapacityPlans returns the cloud plan catalog. It is the same section ListCloudPlans answers and a separate operation because it is a separate address, and an address is what every projection keys on.
ListDNSPlans returns the DNS plan catalog: the tiers priced on zones, records per zone and queries per day.
GET /v1/plans/dns
ListDNSPlans returns the DNS plan catalog: the tiers priced on zones, records per zone and queries per day. It is the canonical catalog for every caller — these plans carry no reseller overrides.
GetPlanEntitlements returns what one plan GRANTS and not what it costs: the canonical namespaced entitlement block and the flat license-feature list derived from it.
GET /v1/plans/entitlements/{id}
GetPlanEntitlements returns what one plan GRANTS and not what it costs: the canonical namespaced entitlement block and the flat license-feature list derived from it. It is the entitlement half of ResolvePlan, over the same catalog and the same 404 for an id no catalog holds — the read a licensing or quota gate makes.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | ID is the plan's catalog id or slug — "pro", "team", "world-enterprise", "rpc-growth". |
put_v1_plans_entries_by_slug
PUT /v1/plans/entries/{slug}
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
slug | path | string | yes |
delete_v1_plans_entries_by_slug
DELETE /v1/plans/entries/{slug}
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
slug | path | string | yes |
get_v1_plans_entries
GET /v1/plans/entries
post_v1_plans_entries
POST /v1/plans/entries
ListGPUTiers returns the rentable GPU configurations, each with its accelerator count and model, VRAM, vCPUs, host memory and hourly price.
GET /v1/plans/gpu
ListGPUTiers returns the rentable GPU configurations, each with its accelerator count and model, VRAM, vCPUs, host memory and hourly price.
Health reports that the plans subsystem is mounted and serving.
GET /v1/plans/health
Health reports that the plans subsystem is mounted and serving. It answers from the process itself and consults neither the catalog bundle nor the goja host, so it stays "ok" while either is degraded.
GetPricingPolicy returns the published pricing policy: whether pricing is transparent, the revenue-sharing terms (idle compute resale and the open-source share) and the principles the catalog is priced by.
GET /v1/plans/policy
GetPricingPolicy returns the published pricing policy: whether pricing is transparent, the revenue-sharing terms (idle compute resale and the open-source share) and the principles the catalog is priced by.
ListRegions returns the regions cloud capacity is offered in, each with its display name and physical location.
GET /v1/plans/regions
ListRegions returns the regions cloud capacity is offered in, each with its display name and physical location.
ResolvePlan resolves one plan to everything a consumer of the catalog needs at once: its canonical entitlement block, the flat license-feature list a signed license carries, its billing reference, and the catalog it came from.
GET /v1/plans/resolve/{id}
ResolvePlan resolves one plan to everything a consumer of the catalog needs at once: its canonical entitlement block, the flat license-feature list a signed license carries, its billing reference, and the catalog it came from. The id may be the plan's id or its slug, and it is resolved against the caller's catalog, so a reseller's override wins over the canonical record. An id no catalog holds answers 404.
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | ID is the plan's catalog id or slug — "pro", "team", "world-enterprise", "rpc-growth". |
GetPlanSchemas returns the two JSON Schema documents this surface speaks: entitlements.schema.json, which declares every entitlement key with its type, unit and enum, and plan.schema.json, which a catalog plan record conforms to.
GET /v1/plans/schema
GetPlanSchemas returns the two JSON Schema documents this surface speaks: entitlements.schema.json, which declares every entitlement key with its type, unit and enum, and plan.schema.json, which a catalog plan record conforms to.
post_v1_plans_seed
POST /v1/plans/seed
GetStoragePricing returns the block-storage price block: the price per GB per month and the volume size bounds a cloud plan may attach.
GET /v1/plans/storage
GetStoragePricing returns the block-storage price block: the price per GB per month and the volume size bounds a cloud plan may attach.
ListSubscriptionPlans returns the subscription ladder — the personal and team tiers a customer buys to use the cloud, each with its monthly and annual price, seat rules, limits and billing reference.
GET /v1/plans/subscriptions
ListSubscriptionPlans returns the subscription ladder — the personal and team tiers a customer buys to use the cloud, each with its monthly and annual price, seat rules, limits and billing reference. Scoped to the caller's catalog.
ListToolPrices returns the per-use price of every metered tool — web search, code interpreter, image generation, speech — each with the unit it is billed in.
GET /v1/plans/tools
ListToolPrices returns the per-use price of every metered tool — web search, code interpreter, image generation, speech — each with the unit it is billed in.
GetEntitlementVocabulary returns the entitlement key vocabulary: every key with its namespace, JSON type, nullability, unit, enum and title, the list of namespaces, and the engine features a license can grant.
GET /v1/plans/vocab
GetEntitlementVocabulary returns the entitlement key vocabulary: every key with its namespace, JSON type, nullability, unit, enum and title, the list of namespaces, and the engine features a license can grant. It is derived from entitlements.schema.json on every call, so it cannot fall behind the schema.
ListCloudPlans returns the Hanzo cloud plan catalog: every cloud tier with its price, included capacity, limits and feature list, scoped to the caller's catalog.
GET /v1/plans
ListCloudPlans returns the Hanzo cloud plan catalog: every cloud tier with its price, included capacity, limits and feature list, scoped to the caller's catalog. A reseller org sees its own overrides in place of the canonical records it has replaced, and the canonical record for every tier it has not.
How is this guide?