---
title: "GET /v2/GetClusterStatistics"
method: GET
path: "/v2/GetClusterStatistics"
tags: ["Cluster"]
---

# GET /v2/GetClusterStatistics

`GET /v2/GetClusterStatistics`

Fetch global cluster statistics.

*Note: do not try to parse the `freeform` field of the response, it is given as a string specifically because its format is not stable.*

## Response `200`

Global cluster statistics

- GetClusterStatisticsResponse
  - `bucketCount` integer, nullable — number of buckets in the cluster
  - `dataAvail` integer, nullable — available storage space for object data in the entire cluster, in bytes
  - `freeform` string, required — cluster statistics as a free-form string, kept for compatibility with nodes running older v2.x versions of garage
  - `incompleteAvailInfo` boolean, nullable — true if the available storage space statistics are imprecise due to missing information of disconnected nodes. When this is the case, the actual space available in the cluster might be lower than the reported values.
  - `metadataAvail` integer, nullable — available storage space for object metadata in the entire cluster, in bytes
  - `totalObjectBytes` integer, nullable — total size of objects stored in all buckets, before compression, deduplication and replication (this is NOT equivalent to actual disk usage in the cluster)
  - `totalObjectCount` integer, nullable — total number of objects stored in all buckets

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/deuxfleurs/apis/garage-administration-api.md) · [All operations](https://skmtc.dev/deuxfleurs/apis/garage-administration-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuxfleurs/garage-administration-api/revisions/07ffb2d0febb/schema)