---
title: "Describe catalog usage"
method: GET
path: "/catalogs/{name}/usage"
---

# Describe catalog usage

`GET /catalogs/{name}/usage`

Returns physical bytes stored by one Tower-managed catalog, including Iceberg metadata and not-yet-compacted snapshot history. Measurements are cached and may be temporarily unavailable; measured_at is null when no measurement exists. BYO and S3 Tables catalogs are not metered.

## Path parameters

- `name` string, required — The name of the catalog.

## Query parameters

- `environment` string — Environment whose catalog usage to return. When it has no same-named catalog, usage for the catalog from default is returned instead.

## Response `200`

OK

- DescribeCatalogUsageResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `environment` string, required — Environment containing the catalog definition.
  - `usage` CatalogUsage, required
    - `measured_at` string, date-time, nullable, required — When this value was measured. Null when metering is unconfigured, disabled, or failed without a cached value.
    - `total_bytes` integer, required — Physical bytes stored by this Tower-managed catalog, including Iceberg metadata and not-yet-compacted snapshot history.

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/tower/apis/tower-api.md) · [All operations](https://skmtc.net/tower/apis/tower-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tower/tower-api/revisions/0e42b0fb26d9/schema)