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

# List machine compute usage breakdown

`GET /v1/usage/machines/compute`

## 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.
- `granularity` string — Usage breakdown granularity: hour or day. Defaults to hour.

## Response `200`

OK

- MachineComputeUsageBody
  - `granularity` string, required — Usage breakdown granularity used for rows: hour or day.
  - `period_end` string, date-time, required — Exclusive usage period end.
  - `period_start` string, date-time, required — Inclusive usage period start.
  - `rows` MachineComputeUsageRowBody[], nullable, required — Machine-level compute usage breakdown rows.
    - `awake_seconds` integer, required — Machine-awake seconds in this bucket.
    - `bucket_end` string, date-time, required — Exclusive usage bucket end.
    - `bucket_start` string, date-time, required — Inclusive usage bucket start.
    - `cpu_millicore_seconds` integer, required — Requested vCPU millicores multiplied by guest-owned active CPU seconds.
    - `last_window_end` string, date-time, required — Latest raw window_end represented by this row.
    - `latest_meter_emitted_at` string, date-time — Latest meter emission timestamp for linked org buckets, when emitted.
    - `machine_id` string, required — Machine identifier.
    - `memory_mib_seconds` integer, required — Requested memory MiB multiplied by running allocation seconds.
    - `org_metering_bucket_ids` string[], nullable, required — Org compute bucket IDs this row contributes to.
    - `requested_memory_mib` integer, required — Requested memory for this shape, in MiB.
    - `requested_storage_gib` integer, required — Requested storage for this shape, in GiB.
    - `requested_vcpu` number, double, required — Requested vCPU for this shape.
    - `spec_fingerprint` string, required — Stable fingerprint for the requested machine shape.
    - `window_count` integer, required — Raw metering events compacted into this row.

## 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)