---
title: "List machine storage usage breakdown"
method: GET
path: "/v1/usage/machines/storage"
tags: ["Usage", "Machine Lifecycle"]
---

# List machine storage usage breakdown

`GET /v1/usage/machines/storage`

## Query parameters

- `period_start` string — Usage period start (YYYY-MM-DD). Defaults to first of current month.
- `period_end` string — Last UTC usage date to include (YYYY-MM-DD). Defaults to current time.
- `machine_id` string — Optional machine ID filter.

## Response `200`

OK

- MachineStorageUsageBody
  - `period_end` string, date-time, required — Exclusive usage period end.
  - `period_start` string, date-time, required — Inclusive usage period start.
  - `rows` MachineStorageUsageRowBody[], nullable, required — Machine-level storage usage breakdown rows.
    - `bucket_end` string, date-time, required — Exclusive usage bucket end.
    - `bucket_start` string, date-time, required — Inclusive usage bucket start.
    - `latest_stripe_emitted_at` string, date-time — Latest Stripe emission timestamp for the linked org bucket, when emitted.
    - `logical_storage_bytes` integer, required — Machine logical bytes observed for storage allocation.
    - `machine_id` string, required — Machine identifier.
    - `org_metering_bucket_id` string, required — Org storage bucket ID this row contributes to.
    - `storage_mib_seconds` integer, required — Allocated logical MiB-seconds for this machine.
    - `stripe_storage_identifier` string, required — Stripe storage meter event identifier linked to that org bucket.

## Other responses

- `400` — Invalid request
- `401` — Authentication required
- `403` — Forbidden
- `500` — Internal server error
- `502` — Billing ledger unavailable
- `default` — Error

## Changes

- **2026-05-12** `e76f392b92b7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dedalus-labs/apis/dedalus-cloud-services-api/changes/v1/usage/machines/storage/get.md)

---

[API](https://skmtc.dev/dedalus-labs/apis/dedalus-cloud-services-api.md) · [All operations](https://skmtc.dev/dedalus-labs/apis/dedalus-cloud-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dedalus-labs/dedalus-cloud-services-api/revisions/e76f392b92b7/schema)