> ## Documentation Index > Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt > Use this file to discover all available pages before exploring further. # List cost catalog > List provider costs, negotiated overrides and custom items with enablement and pricing provenance; supports take/skip and enabled_only. ## OpenAPI ````yaml get /v1/ai/billing/costs openapi: 3.1.0 info: title: Hyperline API version: 0.0.0 servers: - url: https://api.hyperline.co - url: https://sandbox.api.hyperline.co security: [] paths: /v1/ai/billing/costs: get: tags: - AI > Costs summary: List cost catalog description: >- List provider costs, negotiated overrides and custom items with enablement and pricing provenance; supports take/skip and enabled_only. operationId: listAgentCostCatalog parameters: - schema: type: integer minimum: 1 maximum: 10000 default: 10000 description: Maximum catalog entries to return. example: 100 required: false description: Maximum catalog entries to return. name: take in: query - schema: type: - number - 'null' minimum: 0 default: 0 required: false name: skip in: query - schema: anyOf: - type: boolean - type: string enum: - 'true' - 'false' default: false required: false name: enabled_only in: query responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PaginatedAgentCostCatalogEntry' '400': description: Invalid request. content: application/json: schema: type: object properties: message: type: string required: - message '409': description: The request conflicts with the current configuration. content: application/json: schema: type: object properties: message: type: string required: - message security: - bearer: [] components: schemas: PaginatedAgentCostCatalogEntry: type: object properties: meta: type: object properties: total: type: number description: Total of existing items. example: 1 taken: type: number description: Number of items returned. example: 1 skipped: type: number description: Number of items skipped. example: 0 required: - total - taken - skipped data: type: array items: type: object properties: provider: type: string description: >- AI model provider, or the vendor of a custom cost item. This is not an integration connection. example: anthropic model: type: string description: >- Model identifier, or custom item identifier. Null on wildcard pricing rows. example: claude-sonnet-5 aliases: type: array items: type: string description: Alternative model names recognized by the cost catalog. example: - claude-sonnet-5-latest input_per_m_tokens: type: string pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million input tokens, as an exact decimal string. example: '3' output_per_m_tokens: type: string pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million output tokens, as an exact decimal string. example: '15' cached_input_per_m_tokens: type: string pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million cached input tokens, as an exact decimal string. example: '0.3' cache_write_per_m_tokens: type: string pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million cache write tokens, as an exact decimal string. example: '3.75' dimensions: type: array items: type: object properties: key: type: string description: >- Dimension or allowance identifier used by usage payloads and meter results. example: cached_input_tokens rate: type: string description: >- Applied rate. Receipt lines may contain a human-readable rate expression. example: '3' per: type: string enum: - 1m - 1k - unit description: |- Quantity basis for the dimension rate. - 1m: Per million units. - 1k: Per thousand units. - unit: Per single unit. example: 1m required: - key - rate - per description: >- Additional billable dimensions; each key matches a usage_extra key and rates use the owning card's units or USD for cost-catalog dimensions. example: - key: cached_input_tokens rate: '0.3' per: 1m effective_from: type: string format: date-time description: Time the price takes effect, as a UTC ISO 8601 timestamp. example: '2026-09-01T00:00:00Z' source: type: string enum: - official - override - custom - unlisted description: |- Source of the model or item cost. - official: Official model price registry. - override: Negotiated workspace cost override. - custom: Workspace-defined cost item. - unlisted: Observed usage without catalog pricing. example: official custom_item_id: type: - string - 'null' description: >- Active custom cost-item version identifier used to update or delete the item; null for registry models. An update returns a new identifier and preserves historical prices. example: null override: type: - object - 'null' properties: id: type: string description: Unique Hyperline identifier for this resource. example: d18603dd-7285-4bf5-a45e-88d7de8f37c9 input_per_m_tokens: type: string pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million input tokens, as an exact decimal string. example: '3' output_per_m_tokens: type: string pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million output tokens, as an exact decimal string. example: '15' cached_input_per_m_tokens: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million cached input tokens, as an exact decimal string. example: '0.3' cache_write_per_m_tokens: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Provider cost in USD per million cache write tokens, as an exact decimal string. example: '3.75' dimensions: type: array items: type: object properties: key: type: string description: >- Dimension or allowance identifier used by usage payloads and meter results. example: cached_input_tokens rate: type: string description: >- Applied rate. Receipt lines may contain a human-readable rate expression. example: '3' per: type: string enum: - 1m - 1k - unit description: |- Quantity basis for the dimension rate. - 1m: Per million units. - 1k: Per thousand units. - unit: Per single unit. example: 1m required: - key - rate - per description: >- Additional billable dimensions; each key matches a usage_extra key and rates use the owning card's units or USD for cost-catalog dimensions. example: - key: cached_input_tokens rate: '0.3' per: 1m effective_from: type: string format: date-time description: Time the price takes effect, as a UTC ISO 8601 timestamp. example: '2026-09-01T00:00:00Z' required: - id - input_per_m_tokens - output_per_m_tokens - cached_input_per_m_tokens - cache_write_per_m_tokens - effective_from description: >- Negotiated workspace cost override, or null when using registry rates. example: null enabled: type: boolean description: Whether this model is enabled in the workspace catalog. example: true enablement_source: type: string enum: - seen - manual - default_off description: >- Reason for the model enablement state. - seen: Enabled because usage was observed. - manual: Explicitly configured in the workspace. - default_off: Not configured or observed; disabled by default. example: seen required: - provider - model - aliases - input_per_m_tokens - output_per_m_tokens - cached_input_per_m_tokens - cache_write_per_m_tokens - dimensions - effective_from - source - custom_item_id - override - enabled - enablement_source description: List of AgentCostCatalogEntry. required: - meta - data securitySchemes: bearer: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.