> ## 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/ai/billing/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/ai/billing/rate-cards: get: tags: - AI > Billing 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 description: |- Unit in which rate-card prices are expressed. - credits: Credit counts. - units: Weighted rolling-allowance units. - currency: Major units of the specified currency. example: currency required: false description: |- Unit in which rate-card prices are expressed. - credits: Credit counts. - units: Weighted rolling-allowance units. - currency: Major units of the specified currency. name: denomination in: query - schema: type: string enum: - EUR - AED - AFN - XCD - ALL - AMD - AOA - ARS - USD - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - XOF - BMD - BND - BOB - BRL - BSD - BTN - NOK - BWP - BYR - BZD - CAD - CDF - XAF - CHF - NZD - CLP - CNY - COP - CRC - CUP - CVE - ANG - CZK - DJF - DKK - DOP - DZD - EGP - MAD - ERN - ETB - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MDL - MGA - MKD - MMK - MNT - MOP - MRO - MUR - MVR - MWK - MXN - MYR - MZN - NAD - XPF - NGN - NIO - NPR - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SRD - SSP - STD - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - UYU - UZS - VEF - VND - VUV - WST - YER - ZAR - ZMW - ZWL description: >- Currency code. See [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes). example: EUR required: false description: >- Currency code. See [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes). 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' '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: 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 description: Unique Hyperline identifier for this resource. example: d18603dd-7285-4bf5-a45e-88d7de8f37c9 name: type: string description: Human-readable resource name. example: Support agent plan denomination: type: string enum: - credits - units - currency description: |- Unit in which rate-card prices are expressed. - credits: Credit counts. - units: Weighted rolling-allowance units. - currency: Major units of the specified currency. example: currency currency: type: - string - 'null' enum: - EUR - AED - AFN - XCD - ALL - AMD - AOA - ARS - USD - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - XOF - BMD - BND - BOB - BRL - BSD - BTN - NOK - BWP - BYR - BZD - CAD - CDF - XAF - CHF - NZD - CLP - CNY - COP - CRC - CUP - CVE - ANG - CZK - DJF - DKK - DOP - DZD - EGP - MAD - ERN - ETB - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - IRR - ISK - JMD - JOD - JPY - KES - KGS - KHR - KMF - KPW - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MDL - MGA - MKD - MMK - MNT - MOP - MRO - MUR - MVR - MWK - MXN - MYR - MZN - NAD - XPF - NGN - NIO - NPR - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SDG - SEK - SGD - SHP - SLL - SOS - SRD - SSP - STD - SYP - SZL - THB - TJS - TMT - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - UYU - UZS - VEF - VND - VUV - WST - YER - ZAR - ZMW - ZWL description: >- ISO 4217 currency code for monetary values. Null for counts or historical amounts without recorded currency. example: USD fallback_per_usd: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Credits, allowance units, or major currency units per USD of provider cost. Null leaves unmatched usage unpriced. example: '1' rows: type: array items: type: object properties: id: type: string description: Unique Hyperline identifier for this resource. example: d18603dd-7285-4bf5-a45e-88d7de8f37c9 kind: type: string enum: - llm - item description: |- Pricing row kind. - llm: Prices token usage by provider and model. - item: Prices non-LLM usage by vendor and item. example: llm provider: type: - string - 'null' description: >- AI model provider, or the vendor of a custom cost item. This is not an integration connection. example: anthropic model: type: - string - 'null' description: >- Model identifier, or custom item identifier. Null on wildcard pricing rows. example: claude-sonnet-5 rate_per_m_input: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Price per million input tokens, in credits, allowance units, or major currency units according to the card denomination. example: '3' rate_per_m_output: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Price per million output tokens, in the card denomination; currency cards use major currency units. example: '15' rate_unit: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Price per item unit, in the card denomination; currency cards use major currency units. example: '0.01' rate_per_m_cached_input: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Price per million cached input tokens. Null falls back to the card conversion for this dimension. example: '0.3' rate_per_m_cache_write: type: - string - 'null' pattern: ^-?\d+(\.\d+)?(e[+-]?\d+)?$/i description: >- Price per million cache-write tokens. Null falls back to the card conversion for this dimension. example: '3.75' dimensions: type: array items: type: object properties: key: type: string pattern: ^[a-z0-9_.]{1,64}$ description: >- Dimension or allowance identifier used by usage payloads and meter results. example: cached_input_tokens rate: type: string maxLength: 40 pattern: ^\d+(\.\d+)?$ 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 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 description: >- All pricing rows on the card; replacement replaces the complete list. example: [] attached_product_id: type: - string - 'null' description: Credit product using this card as its default, or null. example: prd_credits using_policy_count: type: number description: Number of customer policy scopes referencing this resource. example: 1 using_policies: type: array items: type: object properties: customer_id: type: string description: Hyperline customer identifier. example: cus_example customer_name: type: string description: Customer display name. example: Acme agent_slug: type: - string - 'null' description: >- Agent scope identifier. Null is the customer's shared pool. example: support required: - customer_id - customer_name - agent_slug description: >- Bounded sample of customer scopes using this card; using_policy_count is the complete count. example: - customer_id: cus_example customer_name: Acme agent_slug: support using_plan_count: type: number description: Number of plans referencing this rate card. example: 1 required: - id - name - denomination - currency - 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.