> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountthor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Billing Prices

> Returns each priced resource kind, class, and usage model.



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/admin/billing/price-catalog
openapi: 3.1.0
info:
  title: Mount Thor Customer API
  version: v1
servers:
  - description: Mount Thor customer API edge
    url: https://api.mountthor.com
security: []
paths:
  /v1/admin/billing/price-catalog:
    get:
      tags:
        - billing
      summary: List Billing Prices
      description: Returns each priced resource kind, class, and usage model.
      operationId: get_customer_billing_price_catalog
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerBillingPriceCatalogResponse'
          description: Customer's active price book + items
        '401':
          description: Missing or invalid bearer credential
        '403':
          description: >-
            Credential is missing billing:read scope, or the human session is
            neither an Administrator nor a billing-owner for this customer
        '409':
          description: >-
            Customer has no active contract or the active contract has no price
            book assigned
        '429':
          content:
            text/plain:
              schema:
                type: string
          description: Rate limit exceeded
          headers:
            Retry-After:
              description: Seconds before retry.
              schema:
                minimum: 1
                type: integer
      security:
        - api_key_bearer:
            - billing:read
components:
  schemas:
    CustomerBillingPriceCatalogResponse:
      additionalProperties: false
      description: |-
        Customer-facing price-book catalog response. Surfaces the catalog
        independently of any usage rollup so creation flows (Create Bare Metal
        Machine, Create VM) can render "this class costs $X per `unit`" before
        the customer commits to running anything.
      properties:
        currency:
          description: |-
            ISO 4217 currency code; today always `USD` per umbrella
            scoping decision.
          example: USD
          type: string
        customer_id:
          description: Stable UUID for the customer account.
          type: string
        items:
          description: |-
            Items ordered by (resource_kind, resource_class, usage_model)
            for stable client rendering.
          items:
            $ref: '#/components/schemas/PriceCatalogItem'
          type: array
      required:
        - customer_id
        - currency
        - items
      type: object
    PriceCatalogItem:
      additionalProperties: false
      description: One row in the customer's price-book catalog.
      properties:
        capacity_slots_per_block:
          description: Concurrent resource slots purchased by one billed capacity block.
          format: int32
          type: integer
        minimum_charge_cents:
          description: Exact minimum charge at this item's current rate, in cents.
          format: int64
          type: integer
        minimum_seconds:
          description: |-
            Minimum billable wall-clock window for one capacity slot of this
            resource kind. This is server policy, not client-side math.
          format: int64
          type: integer
        minimum_unit_price_cents:
          format: int64
          type:
            - integer
            - 'null'
        resource_class:
          description: Resource class string (e.g. `mac-m4-pro`).
          example: mac-m4-pro
          type: string
        resource_kind:
          description: '`bare_metal_machine` or `vm`.'
          example: bare_metal_machine
          type: string
        unit:
          example: hour
          type: string
        unit_price_cents:
          description: |-
            Price in cents, denominated in `unit`. 0 for the alpha SKU
            (`alpha-2026`).
          format: int64
          type: integer
        usage_model:
          description: |-
            `reserved` or `on-demand` (`hybrid` is priced as reserved per
            the alpha SKU; the catalog surface only emits the priced
            dimensions a customer can be billed against).
          example: reserved
          type: string
      required:
        - resource_kind
        - resource_class
        - usage_model
        - unit_price_cents
        - unit
        - minimum_seconds
        - minimum_charge_cents
        - capacity_slots_per_block
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````