---
title: "Get usage summary"
method: GET
path: "/v1/usage"
tags: ["Usage", "Machine Lifecycle"]
---

# Get usage summary

`GET /v1/usage`

## Query parameters

- `period_start` string — Billing period start (YYYY-MM-DD). Defaults to first of current month.

## Response `200`

OK

- UsageBody
  - `billed_awake_seconds` integer, required — Closed awake seconds in billed org buckets for the period.
  - `billed_cpu_millicore_seconds` integer, required — Closed requested vCPU millicores multiplied by guest-owned active CPU seconds for the period.
  - `billed_logical_storage_mib_seconds` integer, required — Closed billable logical MiB-seconds for the period.
  - `billed_memory_mib_seconds` integer, required — Closed requested memory MiB multiplied by running allocation seconds for the period.
  - `included_storage_gib` integer, required — Plan-included storage in GiB, used as a local guardrail only.
  - `plan_slug` string, required — Billing plan in effect for the organization.
  - `provisioned_storage_gib` integer, required — Current provisioned storage summed across machines in GiB.

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