Get usage report

Returns meter-level usage aggregated by set granularity over the specified date range.

• Can be filtered by projectNames, paymentMethodIds or meterNames.
• Maximum date range depends on granularity: 31 days (hour), 1 year (day), unlimited (week, month, year).
• Day boundaries use UTC; startDate is inclusive and endDate is exclusive (previously also inclusive).
• To get a monthly report for January, use startDate=2026-01-01 and endDate=2026-02-01.
• The response include date and date_processed fields. date is the time when the usage happened, while date_processed is when the usage was ingested into our system and processed for billing purposes.
• Set filterOnReportedDate=true to filter by date_processed instead of date. This might include usage that occurred before the startDate if it was processed during the date range.
• Set format=csv and download=true to receive a file download.

RBAC Capability Required: core.customer.get