Query the usage data (sparse)

1 min

POST

https://app.amberflo.io/usage/sparse/batch

Queries usage data for multiple meters in batch mode, returning only periods with actual usage events. Takes an array of usage queries and returns sparse results without time series gap filling.

Common use cases:

Bulk export of raw usage data across multiple meters
Retrieve actual usage patterns for external analytics systems
Compare sparse usage events between different meters efficiently
Generate reports that focus only on active usage periods

Each query supports the same filtering and grouping options as individual sparse queries, returning only time periods where usage events were recorded.

Important: Returns sparse data without time series interpolation. For continuous charting, use the standard batch usage query instead.

bodyarrayQuery parameters for retrieving aggregated meter usage data with filtering and grouping options

200Successful request

curl --request POST \
     --url https://app.amberflo.io/usage/sparse/batch \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '[
     {
     "meterApiName": "",
     "timeRange": {
     "startTimeInSeconds": 0
     },
     "take": {
     "limit": 0
     },
     "forecast": {
     "endTimeInSeconds": 0
     }
     }
     ]'