---
title: "Get cluster utilization stats"
method: GET
path: "/api/v1/k8s/clusters/stats"
tags: ["Kubernetes"]
---

# Get cluster utilization stats

`GET /api/v1/k8s/clusters/stats`

Batch utilization snapshot for one or more clusters (CPU, memory, pods, node readiness). Values refresh every 60 seconds.

## Query parameters

- `ids` string

## Headers

- `X-Project-ID` string, uuid, required

## Response `200`

Utilization per cluster

- object
  - `success` boolean
  - `stats` K8sClusterStats[]
    - `cluster_id` string — Short cluster ID
    - `has_data` boolean
    - `cpu_used_millicores` integer
    - `cpu_capacity_millicores` integer
    - `mem_used_bytes` integer
    - `mem_capacity_bytes` integer
    - `pod_count` integer
    - `nodes_ready` integer
    - `nodes_total` integer
    - `metrics_updated_at` string, date-time

## Other responses

- `401` — Authentication required

## Changes

- **2026-08-24** `622c9f879b84` — 1 breaking
  - added the new required `header` request parameter `X-Project-ID`
- **2026-08-23** `72c803a128b2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/k8s/clusters/stats/get.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/8ce5caecc863/schema)