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

# Get Fleet Summary

> Returns customer-safe resource inventory plus exact paid VM block
occupancy. Capacity configuration and availability are exposed by their
dedicated canonical endpoints.



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json get /v1/admin/fleet/summary
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/summary:
    get:
      tags:
        - fleet
      summary: Get Fleet Summary
      description: |-
        Returns customer-safe resource inventory plus exact paid VM block
        occupancy. Capacity configuration and availability are exposed by their
        dedicated canonical endpoints.
      operationId: get_fleet_summary
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FleetSummaryResponse'
          description: Fleet summary for this tenant
        '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:
    FleetSummaryResponse:
      additionalProperties: false
      description: >-
        Customer-safe fleet summary containing inventory plus exact paid VM
        block

        occupancy. The canonical physical commitment and its cross-product usage

        live in `/v1/admin/fleet/capacity`; launch availability comes only from
        the

        allocator-backed machine-availability endpoint.
      properties:
        resources:
          description: Per-resource inventory with capacity source attribution.
          items:
            $ref: '#/components/schemas/FleetResourceEntry'
          type: array
        vm_capacity_by_image:
          description: Active paid two-slot blocks grouped by normalized VM imageRef.
          items:
            $ref: '#/components/schemas/VmCapacityBlockSummary'
          type: array
      required:
        - vm_capacity_by_image
        - resources
      type: object
    FleetResourceEntry:
      additionalProperties: false
      description: A single resource in the fleet inventory.
      properties:
        capacity_source:
          description: 'Capacity source: "reserved", "on-demand", or "unknown".'
          example: reserved
          type: string
        kind:
          description: 'Resource kind: "BareMetalMachine" or "VirtualMachine".'
          example: VirtualMachine
          type: string
        name:
          description: Kubernetes object name.
          example: dev
          type: string
        phase:
          description: Current lifecycle phase.
          example: Running
          type: string
      required:
        - kind
        - name
        - phase
        - capacity_source
      type: object
    VmCapacityBlockSummary:
      additionalProperties: false
      description: Customer-visible occupancy of image-scoped two-VM capacity blocks.
      properties:
        blocks_total:
          format: int32
          type: integer
        image_ref:
          type: string
        slots_available:
          format: int32
          type: integer
        slots_in_use:
          format: int32
          type: integer
        slots_total:
          format: int32
          type: integer
      required:
        - image_ref
        - blocks_total
        - slots_total
        - slots_in_use
        - slots_available
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````