> ## Documentation Index > Fetch the complete documentation index at: https://docs.costgraph.ai/llms.txt > Use this file to discover all available pages before exploring further. # List kubernetes cluster autopilot node pools > Returns, per node pool AutoPilot owns or where the workloads it currently runs on freed, added or moved capacity in the period, its average nodes, capacity, cost, price per unit and spot share over the period, the capacity AutoPilot sizing freed and added in it, the CPU moved into and out of it by placement (both counting only workloads AutoPilot currently runs on), and an estimate of how many nodes the net freed capacity is worth on the pool's dominant resource (GPU when the pool has GPUs, otherwise the costlier of CPU and memory). Capacity figures are averaged over the period's hours with recorded data; cost_usd is the pool's cost over the period, null when none of its nodes could be priced. Freed and added are capacity, not bill savings; the estimate is null when the pool had no nodes in the period. from and to are RFC 3339 and truncated to the hour, to is exclusive; the default is the last 30 days ending at the last closed hour; a period over 400 days is rejected. ## OpenAPI ````yaml /api-reference/costgraph/openapi.json get /api/v1/tenant/clusters/{cluster_id}/autopilot/pools openapi: 3.0.0 info: description: Read and manage your CostGraph organization, spend, alerts, and settings. title: CostGraph API contact: {} version: '1.0' servers: - url: https://api.costgraph.ai security: [] tags: - name: ai x-group: AI - name: ai-serving x-group: AI serving - name: anomalies x-group: Anomalies - name: auth x-group: Auth - name: billing x-group: Billing - name: billing-export x-group: Billing export - name: budgets x-group: Budgets - name: ci x-group: CI - name: compute-recommendations x-group: Compute recommendations - name: config x-group: Config - name: context-graph x-group: Context graph - name: cost x-group: Cost - name: gpus x-group: GPUs - name: graphai x-group: Graph AI - name: integrations x-group: Integrations - name: invitations x-group: Invitations - name: kubernetes-clusters x-group: Kubernetes clusters - name: marketplace x-group: Marketplace - name: network x-group: Network - name: network-requests x-group: Network requests - name: notifications x-group: Notifications - name: oauth x-group: OAuth - name: oauth-clients x-group: OAuth clients - name: opencost x-group: OpenCost - name: organization x-group: Audit log - name: organizations x-group: Organizations - name: placement-alternatives x-group: Placement alternatives - name: reports x-group: Reports - name: settings x-group: Settings - name: sso x-group: Single sign-on - name: tenants x-group: Tenants - name: ticketing x-group: Ticketing - name: user x-group: Users - name: virtual-machines x-group: Virtual machines - name: virtual-tags x-group: Virtual tags - name: workflows x-group: Workflows paths: /api/v1/tenant/clusters/{cluster_id}/autopilot/pools: get: tags: - kubernetes-clusters summary: List kubernetes cluster autopilot node pools description: >- Returns, per node pool AutoPilot owns or where the workloads it currently runs on freed, added or moved capacity in the period, its average nodes, capacity, cost, price per unit and spot share over the period, the capacity AutoPilot sizing freed and added in it, the CPU moved into and out of it by placement (both counting only workloads AutoPilot currently runs on), and an estimate of how many nodes the net freed capacity is worth on the pool's dominant resource (GPU when the pool has GPUs, otherwise the costlier of CPU and memory). Capacity figures are averaged over the period's hours with recorded data; cost_usd is the pool's cost over the period, null when none of its nodes could be priced. Freed and added are capacity, not bill savings; the estimate is null when the pool had no nodes in the period. from and to are RFC 3339 and truncated to the hour, to is exclusive; the default is the last 30 days ending at the last closed hour; a period over 400 days is rejected. parameters: - description: Tenant ID name: X-CostGraph-Tenant-ID in: header required: true schema: type: string - description: Kubernetes cluster ID name: cluster_id in: path required: true schema: type: string - description: Period start (RFC 3339, inclusive) name: from in: query schema: type: string - description: Period end (RFC 3339, exclusive) name: to in: query schema: type: string responses: '200': description: OK content: application/json: schema: allOf: - $ref: '#/components/schemas/responses.SuccessResponse' - type: object properties: data: $ref: '#/components/schemas/operator.AutopilotPoolSavingsList' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' security: - BearerAuth: [] components: schemas: responses.SuccessResponse: type: object required: - message - status properties: data: {} message: type: string example: some message status: type: string example: success operator.AutopilotPoolSavingsList: type: object required: - from - items - to properties: from: type: string items: type: array items: $ref: '#/components/schemas/operator.AutopilotPoolSavings' to: type: string responses.ErrorResponse: type: object required: - message - status properties: message: type: string example: some message status: type: string example: error operator.AutopilotPoolSavings: type: object required: - added_cpu_cores - added_gpus - added_memory_gib - autoscaler - avg_nodes - cpu_cores - freed_cpu_cores - freed_gpus - freed_memory_gib - gpus - memory_gib - moved_in_cpu_cores - moved_out_cpu_cores - pool - spot_share properties: added_cpu_cores: type: number added_gpus: type: number added_memory_gib: type: number autoscaler: type: string avg_nodes: type: number cost_usd: type: number x-semantic: costAmount nullable: true cpu_core_usd_per_hour: type: number x-semantic: costAmount nullable: true cpu_cores: type: number estimated_nodes_worth: type: number nullable: true freed_cpu_cores: type: number freed_gpus: type: number freed_memory_gib: type: number gpu_usd_per_hour: type: number x-semantic: costAmount nullable: true gpus: type: number memory_gib: type: number memory_gib_usd_per_hour: type: number x-semantic: costAmount nullable: true moved_in_cpu_cores: type: number moved_out_cpu_cores: type: number pool: type: string spot_share: type: number securitySchemes: BearerAuth: description: Enter "Bearer {token}" type: apiKey name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.