> ## 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 Usage

> Returns usage grouped by resource class for a live window (`24h`, `7d`,
`month`) or a closed calendar month (`YYYY-MM`). Open lifecycles report
elapsed raw time; billing minimums are applied only when the lifecycle
closes.



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/admin/fleet/usage
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/fleet/usage:
    get:
      tags:
        - fleet
      summary: List Usage
      description: |-
        Returns usage grouped by resource class for a live window (`24h`, `7d`,
        `month`) or a closed calendar month (`YYYY-MM`). Open lifecycles report
        elapsed raw time; billing minimums are applied only when the lifecycle
        closes.
      operationId: get_customer_fleet_usage
      parameters:
        - description: 'Window: `24h`, `7d`, `month`, or a closed `YYYY-MM` calendar month.'
          in: query
          name: period
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerFleetUsageResponse'
          description: Fleet usage view for the tenant
        '400':
          description: Unsupported period value
        '401':
          description: Missing or invalid customer API key
        '403':
          description: API key is missing compute:read scope
        '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:
            - compute:read
components:
  schemas:
    CustomerFleetUsageResponse:
      additionalProperties: false
      description: Fleet usage response for the requested period.
      properties:
        buckets:
          description: Time-series usage buckets.
          items:
            $ref: '#/components/schemas/UsageBucket'
          type: array
        customer_id:
          description: Stable UUID for the customer account.
          type: string
        period:
          $ref: '#/components/schemas/UsagePeriod'
          description: Window and bucket size used for this response.
        summary:
          $ref: '#/components/schemas/UsageSummary'
          description: Totals for the entire window.
        tenant_id:
          description: Stable UUID for the tenant.
          type: string
      required:
        - customer_id
        - tenant_id
        - period
        - summary
        - buckets
      type: object
    UsageBucket:
      additionalProperties: false
      description: Usage measurement for one resource group in a period.
      properties:
        bucket_start:
          description: Start timestamp for this bucket.
          example: '2026-05-24T17:00:00Z'
          type: string
        by_class:
          description: Usage grouped by resource class inside this bucket.
          items:
            $ref: '#/components/schemas/UsageByClass'
          type: array
      required:
        - bucket_start
        - by_class
      type: object
    UsagePeriod:
      additionalProperties: false
      description: Inclusive usage query period.
      properties:
        bucket:
          description: '`hour` for 24h window, `day` for 7d and month.'
          example: hour
          type: string
        end:
          description: Exclusive end of the usage window.
          example: '2026-05-25T00:00:00Z'
          type: string
        start:
          description: Inclusive start of the usage window.
          example: '2026-05-24T00:00:00Z'
          type: string
      required:
        - start
        - end
        - bucket
      type: object
    UsageSummary:
      additionalProperties: false
      description: Aggregate usage totals for the requested period.
      properties:
        billable_seconds:
          description: Total billable seconds across the requested window.
          format: int64
          type: integer
        by_class:
          description: Window totals grouped by resource class.
          items:
            $ref: '#/components/schemas/UsageByClass'
          type: array
        lifecycle_count:
          description: Total lifecycle count across the requested window.
          format: int64
          type: integer
        raw_active_seconds:
          description: Total wall-clock active seconds across the requested window.
          format: int64
          type: integer
      required:
        - lifecycle_count
        - raw_active_seconds
        - billable_seconds
        - by_class
      type: object
    UsageByClass:
      additionalProperties: false
      description: Usage measurement grouped by resource class.
      properties:
        billable_seconds:
          description: >-
            Billable seconds after per-class minimums are applied to closed
            lifecycles.
          format: int64
          type: integer
        lifecycle_count:
          description: Number of closed or open lifecycles counted in this group.
          format: int64
          type: integer
        raw_active_seconds:
          description: Wall-clock active seconds before billing minimums are applied.
          format: int64
          type: integer
        resource_class:
          description: Resource class or image class that usage is grouped under.
          example: m4-24g
          type: string
        resource_kind:
          description: >-
            Compute resource family, such as `BareMetalMachine` or
            `VirtualMachine`.
          example: BareMetalMachine
          type: string
      required:
        - resource_kind
        - resource_class
        - lifecycle_count
        - raw_active_seconds
        - billable_seconds
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````