Skip to content

API v2 · 2 November 2026

Lists return each resource's usage to date with include=usage

A list of a metered resource (GET /v2/{resources}, for every resource that has :usage) accepts include=usage, which adds usage to the page: each item's ID mapped to what it has used from the month it was created (since) to now, with the same figures as :usage (windows, heldMs, cpuBilledUsec, memoryMibMs and chargedMicros), summed over those months. The page is still one request, so a list that shows each resource's cost no longer needs one :usage call per item. Any other include value returns 400, as does include on a resource that is not metered. The TypeScript, Python, Go, Ruby and Java SDKs take include on list and return the page's usage, and the CLI takes --include usage.

Same day.

Cut your cloud billby 75%.

No card to start. Billed by the second after.

Start free, no card