List usage

Consumed quantity per time bucket, groupable by FOCUS columns; quantities of different units stay on separate rows and are never added together.

GET /organization/v1/usage● Supported

Request parameters

starting_atstring必填
query: Window start (inclusive), UTC ISO 8601, e.g. 2026-09-26T00:00:00Z
ending_atstring必填
query: Window end (exclusive), UTC ISO 8601; at most 93 days after starting_at (the charges export has no such cap)
bucket_widthstring必填
query: Bucket width: 1h (aligned to the hour) or 1d (aligned to the UTC day)
取值 1h1d
time_zonestring可选
默认 "UTC"
query: IANA time zone name (for example Asia/Shanghai) whose local hours or days form the buckets. Defaults to UTC. Offsets such as +08:00 are rejected. The window widens to whole local buckets; a day that crosses a daylight-saving change lasts 23 or 25 hours. starting_at and ending_at stay UTC instants.
group_byarray可选
query: Columns to group by (repeatable): ServiceName, ServiceCategory, ResourceId, ConsumedUnit; usage always splits ConsumedUnit out server-side
pagestring可选
query: The opaque cursor from the previous page's next_page — pass it back unchanged

200 page

Errors follow the problem+json format — see error codes

Usage page

application/json

Name	Type	Description
object	string	Object type; always `page`.
data	array<object>	Usage buckets in time order, one per hour or day of the requested window.
data[].object	string	Object type; always `bucket`.
data[].starting_at	string	Start of the bucket, UTC, inclusive.
data[].ending_at	string	End of the bucket, UTC, exclusive.
data[].estimated	boolean	Always false; kept for the AWS GetCostAndUsage shape.
data[].results	array<object>	Aggregates of the bucket, one entry per group requested with group_by.
has_more	boolean	Whether more results exist beyond this page; request again with `page` set to `next_page` to read them.
next_page	string \| null	Opaque cursor for the next page; null on the last page. Pass it unchanged as `page`.

Field	Description
`object / data[].object`	always "page" / always "bucket"
`data[].starting_at / data[].ending_at / data[].estimated`	Bucket start/end (UTC) and the estimated marker (always false), same as costs
`data[].results[].ServiceName / ServiceCategory`	Service columns (present only when requested)
`data[].results[].ResourceId / data[].results[].ResourceName`	Resource columns; ResourceName rides ResourceId
`data[].results[].ConsumedQuantity`	The group's consumed quantity, a decimal string
`data[].results[].ConsumedUnit`	The consumption unit; different units stay on separate rows and are never added together
`has_more / next_page`	Cursor pagination, same as costs

For the transactions behind one event see Get a usage event.