v1
latestOpenAPI 3.1.02026-07-222392081.7 MBCustomers > Usage
Get customer usage timeseries
Get the usage of a customer for an aggregator bucketed by month, day or hour.
get/v1/customers/{id}/usage/{aggregator_id}/timeseries
Path parameters
idstring required
aggregator_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.
aggregator_filter_idstring
Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.
Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.
group_by'month' | 'day' | 'hour'
Bucket size for the timeseries.
Bucket size for the timeseries.