---
title: "Get space usage"
method: GET
path: "/spaces/{space_id}/usage"
---

# Get space usage

`GET /spaces/{space_id}/usage`

Returns compute usage, storage usage, and billing/cost information for a space.

## Path parameters

- `space_id` string, required

## Response `200`

Space usage

- SpaceUsage — Space-level usage and cost for the current billing cycle.
  - `storage_mib` integer, required — Total storage used across all databases in the space, in MiB.
  - `storage_limit_mib` integer, required — Storage quota for the space, in MiB.
  - `compute_minutes` integer, required — Total compute minutes used across all databases in the space during the current billing cycle.
  - `free_compute_minutes` integer, required — Compute minutes included per billing cycle at no additional charge, shared across all standard databases in the space. Usage beyond this is billed only when `overages_enabled` is true.
  - `compute_limit_minutes` integer, nullable — Compute-minute quota for the space. When exceeded, all standard databases in the space are automatically paused. `null` means no limit — only possible when `overages_enabled` is true.
  - `overages_enabled` boolean, required — Whether the space has compute overages enabled.
  - `cost_to_date` number, double — Gross cost accrued so far this billing cycle.
  - `estimated_total_cost` number, double — Projected gross total for the current billing cycle based on usage to date.
  - `billing_period_start` string, date-time — Start of the current billing cycle.
  - `billing_period_end` string, date-time — End of the current billing cycle.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/timescale/apis/ghost-api.md) · [All operations](https://skmtc.net/timescale/apis/ghost-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timescale/ghost-api/versions/808022f897be/schema)