---
title: "GET /v1/billing/usage/storage — per-volume/per-day storage for the key's org."
method: GET
path: "/v1/billing/usage/storage"
tags: ["billing"]
---

# GET /v1/billing/usage/storage — per-volume/per-day storage for the key's org.

`GET /v1/billing/usage/storage`

Return persistent storage usage grouped by volume for a selected UTC time range.

## Response `200`

Per-volume / per-day storage usage

- StorageBreakdown — Per-volume durable-storage usage breakdown for an org over a window: per-(volume, day) rows plus a directory of the volumes they reference. The storage sibling of [`UsageBreakdown`](crate::UsageBreakdown). Deleted volumes' accruals persist, so `rows` may reference `volume_id`s absent from `volumes`; the client labels those as deleted.
  - `rows` StorageDailyUsage[], required
    - `day` string, date-time, required — UTC midnight of the day this usage falls in.
    - `mib_seconds` number, double, required — Σ(used_mib × overlap_seconds) for this volume on this day.
    - `volume_id` string, uuid, required
  - `volumes` VolumeIdentity[], required
    - `id` string, uuid, required
    - `name` string, nullable — `None` for the host volume (nameless).

## Other responses

- `401` — Unauthorized

---

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