---
title: "Get CMX usage stats."
method: GET
path: "/cmx/stats"
tags: ["cmx"]
---

# Get CMX usage stats.

`GET /cmx/stats`

Required RBAC Policy: kots/cluster/list

## Response `200`

GetCMXStatsResponse contains the response to get CMX stats.

- object
  - `cluster_count` integer — Total number of clusters.
  - `cost` integer — Total cost of all clusters and VMs in cents.
  - `credit_balance` integer — Total remaining credit balance in cents.
  - `error` string
  - `usage_minutes` integer — Total number of usage minutes across clusters and VMs.
  - `vm_count` integer — Total number of VMs.

## Other responses

- `400` — Returned on bad input
- `401` — Return if the caller is not authorized
- `403` — Returned if the caller does not have the needed permission
- `404` — Returned on resource not found

---

[API](https://skmtc.net/replicated/apis/vendor-api-v3.md) · [All operations](https://skmtc.net/replicated/apis/vendor-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3/revisions/6fcf9e54aba4/schema)