> ## 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 agent rate cards

> The named sets of rows that price AI usage — in credits, in weighted window units, or in real money. `using_policy_count`, `using_plan_count` and `attached_product_id` say what depends on each card, which is what the DELETE refuses over. Filter by `denomination`, `currency` or `search`; paginated with take/skip.



## OpenAPI

````yaml get /v1/agents/rate-cards
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/rate-cards:
    get:
      tags:
        - Agents
      summary: List agent rate cards
      description: >-
        The named sets of rows that price AI usage — in credits, in weighted
        window units, or in real money. `using_policy_count`, `using_plan_count`
        and `attached_product_id` say what depends on each card, which is what
        the DELETE refuses over. Filter by `denomination`, `currency` or
        `search`; paginated with take/skip.
      operationId: listAgentRateCards
      parameters:
        - schema:
            type: string
            enum:
              - credits
              - units
              - currency
          required: false
          name: denomination
          in: query
        - schema:
            type: string
            minLength: 3
            maxLength: 3
          required: false
          name: currency
          in: query
        - schema:
            type: string
          required: false
          name: search
          in: query
        - schema:
            type:
              - number
              - 'null'
            minimum: 0
            maximum: 100
            default: 50
          required: false
          name: take
          in: query
        - schema:
            type:
              - number
              - 'null'
            minimum: 0
            default: 0
          required: false
          name: skip
          in: query
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAgentRateCard'
      security:
        - bearer: []
components:
  schemas:
    PaginatedAgentRateCard:
      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:
              id:
                type: string
              name:
                type: string
              denomination:
                type: string
                enum:
                  - credits
                  - units
                  - currency
              currency:
                type:
                  - string
                  - 'null'
              description:
                type:
                  - string
                  - 'null'
              fallback_per_usd:
                type:
                  - string
                  - 'null'
              rows:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    kind:
                      type: string
                      enum:
                        - llm
                        - item
                    provider:
                      type:
                        - string
                        - 'null'
                    model:
                      type:
                        - string
                        - 'null'
                    rate_per_m_input:
                      type:
                        - string
                        - 'null'
                    rate_per_m_output:
                      type:
                        - string
                        - 'null'
                    rate_unit:
                      type:
                        - string
                        - 'null'
                    rate_per_m_cached_input:
                      type:
                        - string
                        - 'null'
                    rate_per_m_cache_write:
                      type:
                        - string
                        - 'null'
                    dimensions:
                      type: array
                      items:
                        type: object
                        properties:
                          key:
                            type: string
                            pattern: ^[a-z0-9_.]{1,64}$
                          rate:
                            type: string
                            maxLength: 40
                            pattern: ^\d+(\.\d+)?$
                          per:
                            type: string
                            enum:
                              - 1m
                              - 1k
                              - unit
                        required:
                          - key
                          - rate
                          - per
                  required:
                    - id
                    - kind
                    - provider
                    - model
                    - rate_per_m_input
                    - rate_per_m_output
                    - rate_unit
                    - rate_per_m_cached_input
                    - rate_per_m_cache_write
                    - dimensions
              attached_product_id:
                type:
                  - string
                  - 'null'
              using_policy_count:
                type: number
              using_policies:
                type: array
                items:
                  type: object
                  properties:
                    customer_id:
                      type: string
                    customer_name:
                      type: string
                    agent_slug:
                      type: string
                  required:
                    - customer_id
                    - customer_name
                    - agent_slug
              using_plan_count:
                type: number
            required:
              - id
              - name
              - denomination
              - currency
              - description
              - fallback_per_usd
              - rows
              - attached_product_id
              - using_policy_count
              - using_policies
              - using_plan_count
          description: List of AgentRateCard.
      required:
        - meta
        - data
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````