v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-123350354.0 KB
Usage
Machine Lifecycle

Get usage summary

get/v1/usage

Query parameters

period_startstring

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

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

Response

OK

billed_awake_secondsinteger required

Closed awake seconds in billed org buckets for the period.

billed_cpu_millicore_secondsinteger required

Closed requested vCPU millicores multiplied by guest-owned active CPU seconds for the period.

billed_logical_storage_mib_secondsinteger required

Closed billable logical MiB-seconds for the period, matching the Stripe storage meter.

billed_memory_mib_secondsinteger required

Closed requested memory MiB multiplied by running allocation seconds for the period.

included_storage_gibinteger required

Plan-included storage in GiB, used as a local guardrail only.

plan_slugstring required

Billing plan in effect for the organization.

provisioned_storage_gibinteger required

Current provisioned storage summed across machines in GiB.