> ## 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 the agent cost catalog

> What the workspace's AI usage is priced against: the global registry row in force right now for each (provider, model) merged with the workspace's own negotiated override, then the workspace's custom cost items (`source: "custom"`, `custom_item_id` set), then the (provider, model) pairs this workspace's telemetry has carried that nothing prices (`source: "unlisted"`). An unlisted row is unpriced — its rates are zero because there is no catalog entry, never because the vendor is free — so never render it as $0; price it by creating a custom cost item for the same pair and traffic from then on is priced. Token rates are USD per million tokens, `dimensions` holds the extra cost dimensions, and every rate is a decimal string. Each row also carries whether the model is in the workspace's catalog (`enabled`) and why (`enablement_source`): `seen` when the workspace has actually called it, `manual` when somebody answered for it explicitly, `default_off` for a registry model never touched. Pass `enabled_only=true` for just the catalog; the default is the whole registry.



## OpenAPI

````yaml get /v1/agents/cost-catalog
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/agents/cost-catalog:
    get:
      tags:
        - Agents
      summary: List the agent cost catalog
      description: >-
        What the workspace's AI usage is priced against: the global registry row
        in force right now for each (provider, model) merged with the
        workspace's own negotiated override, then the workspace's custom cost
        items (`source: "custom"`, `custom_item_id` set), then the (provider,
        model) pairs this workspace's telemetry has carried that nothing prices
        (`source: "unlisted"`). An unlisted row is unpriced — its rates are zero
        because there is no catalog entry, never because the vendor is free — so
        never render it as $0; price it by creating a custom cost item for the
        same pair and traffic from then on is priced. Token rates are USD per
        million tokens, `dimensions` holds the extra cost dimensions, and every
        rate is a decimal string. Each row also carries whether the model is in
        the workspace's catalog (`enabled`) and why (`enablement_source`):
        `seen` when the workspace has actually called it, `manual` when somebody
        answered for it explicitly, `default_off` for a registry model never
        touched. Pass `enabled_only=true` for just the catalog; the default is
        the whole registry.
      operationId: listAgentCostCatalog
      parameters:
        - 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:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        provider:
                          type: string
                        model:
                          type: string
                        aliases:
                          type: array
                          items:
                            type: string
                        input_per_m_tokens:
                          type: string
                        output_per_m_tokens:
                          type: string
                        cached_input_per_m_tokens:
                          type: string
                        cache_write_per_m_tokens:
                          type: string
                        dimensions:
                          type: array
                          items:
                            type: object
                            properties:
                              key:
                                type: string
                              rate:
                                type: string
                              per:
                                type: string
                                enum:
                                  - 1m
                                  - 1k
                                  - unit
                            required:
                              - key
                              - rate
                              - per
                        effective_from:
                          type: string
                        source:
                          type: string
                        custom_item_id:
                          type:
                            - string
                            - 'null'
                        override:
                          type:
                            - object
                            - 'null'
                          properties:
                            id:
                              type: string
                            input_per_m_tokens:
                              type: string
                            output_per_m_tokens:
                              type: string
                            cached_input_per_m_tokens:
                              type:
                                - string
                                - 'null'
                            cache_write_per_m_tokens:
                              type:
                                - string
                                - 'null'
                            dimensions:
                              type: array
                              items:
                                type: object
                                properties:
                                  key:
                                    type: string
                                  rate:
                                    type: string
                                  per:
                                    type: string
                                    enum:
                                      - 1m
                                      - 1k
                                      - unit
                                required:
                                  - key
                                  - rate
                                  - per
                            effective_from:
                              type: string
                          required:
                            - id
                            - input_per_m_tokens
                            - output_per_m_tokens
                            - cached_input_per_m_tokens
                            - cache_write_per_m_tokens
                            - effective_from
                        enabled:
                          type: boolean
                        enablement_source:
                          type: string
                          enum:
                            - seen
                            - manual
                            - default_off
                      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
                required:
                  - data
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````