---
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_meter_emitted_at` string, date-time — Latest meter 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.

## Other responses

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

---

[API](https://skmtc.net/dedaluslabs/apis/dedalus-cloud-services-api.md) · [All operations](https://skmtc.net/dedaluslabs/apis/dedalus-cloud-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dedaluslabs/dedalus-cloud-services-api/versions/3ea9da83cd8c/schema)