Hanzo
OpenapiO11y

Returns the LLM pricing rules for the caller's org, with pagination and an…

Returns the LLM pricing rules for the caller's org, with pagination and an optional search and override filter.

GET /v1/o11y/llm_pricing_rules

Addresshttps://api.hanzo.ai/v1/o11y/llm_pricing_rules
MethodGET
OperationListLLMPricingRules
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the LLM pricing rules for the caller's org, with pagination and an optional search and override filter.

Callers need the viewer role; the runtime's own gate enforces it.

Request

4 fields.

FieldInTypeRequiredDescription
qquerystringSearch matches rules by model or provider.
isOverridequerystringIsOverride, when "true" or "false", narrows to user-pinned rules or to synced ones; empty returns both.
offsetqueryintegerOffset is how many rows to skip, for paging.
limitqueryintegerLimit caps how many rows come back.

Response

StatusBodyMeaning
200o11y.O11yLLMPricingRulesOutok

200 body — 27 fields.

FieldInTypeAlwaysDescription
databodyo11y.O11yLLMPricingRulesPage
data.itemsbodyo11y.O11yLLMPricingRule[]Items are the rules.
data.items[].createdAtbodystring (date-time)CreatedAt is when the rule was stored.
data.items[].createdBybodystringCreatedBy is who created the rule.
data.items[].enabledbodybooleanEnabled says whether the rule is on.
data.items[].idbodystringID is the rule's id.
data.items[].isOverridebodybooleanIsOverride marks the rule user-pinned; when true the sync job skips it.
data.items[].modelNamebodystringModel is the model the rule prices.
data.items[].modelPatternbodystring[]ModelPattern are the model-name globs the rule matches.
data.items[].orgIdbodystringOrgID is the org the rule belongs to.
data.items[].pricingbodyo11y.O11yLLMRulePricing
data.items[].pricing.cachebodyo11y.O11yLLMPricingCacheCosts
data.items[].pricing.cache.modebodystringMode is how cached tokens are counted — subtract (inside input_tokens, OpenAI-style), additive (reported separately, Anthropic-style) or unknown.
data.items[].pricing.cache.readbodynumberRead is the cost per unit of cache-read tokens.
data.items[].pricing.cache.writebodynumberWrite is the cost per unit of cache-write tokens.
data.items[].pricing.inputbodynumberInput is the cost per unit of input tokens.
data.items[].pricing.outputbodynumberOutput is the cost per unit of output tokens.
data.items[].providerbodystringProvider is the model's provider.
data.items[].sourceIdbodystringSourceID is the upstream source the rule was synced from, when synced.
data.items[].syncedAtbodystring (date-time)SyncedAt is when the rule was last synced, when it is synced.
data.items[].unitbodystringUnit is the pricing unit, e.g.
data.items[].updatedAtbodystring (date-time)UpdatedAt is when the rule last changed.
data.items[].updatedBybodystringUpdatedBy is who last changed it.
data.limitbodyintegerLimit is the page cap the read ran with.
data.offsetbodyintegerOffset is the row offset this page started at.
data.totalbodyintegerTotal is how many rules match, across all pages.
statusbodystringStatus is "success".

Failure carries the platform error shape — see Errors.

Examples

hanzo o11y llm_pricing_rules list

O11y API · All Hanzo APIs · Interactive reference

How is this guide?

On this page