v1

latestOpenAPI 3.1.02026-07-222392081.7 MB

Customers > Usage

List customer usage

List one usage row per aggregator for a single customer over a period. Use GET /v1/aggregators/{id}/usage/group-by-customer for the inverse: one row per customer for a single aggregator.

get/v1/customers/{id}/usage

Path parameters

idstring required

Query parameters

start_datestring date-time required

ISO-8601 date string.

Example:2026-01-01T00:00:00Z

ISO-8601 date string.

end_datestring date-time required

ISO-8601 date string.

Example:2026-02-01T00:00:00Z

ISO-8601 date string.

Response

aggregator_idstring required

Aggregator ID.

namestring required

Display name.

unit_namestring nullable required

Unit name.

totalnumber required

Total usage over the period.

countnumber required

Number of events behind the total.