Fetch the current customer usage-rate

1 min

GET

https://app.amberflo.io/usage/current-usage-rate

Retrieves the current usage rate for a specific customer and meter. Provides real-time usage metrics to support rate limiting and capacity management.

Returns different metrics based on meter type:

Momentary meters (Sum): Frequency of system usage measured as total usage in the last hour
Long-lasting meters (Max, Duration, Running Total): Current scale of resource consumption like active storage usage

Common use cases:

Implement usage-based rate limiting (queries per hour)
Enforce capacity policies (maximum storage per customer)
Monitor real-time resource consumption
Trigger alerts when usage thresholds are exceeded

Important: Usage rates reflect recent activity and current resource allocation. Response times depend on meter complexity and event volume.

meterApiNamestringTechnical identifier of the meter to query. Must match an existing meter in your account.

customerIdstringUnique identifier of the customer whose current usage rate to retrieve.

groupByEventIdbooleanWhether to group results by event ID dimension when meter includes eventId in aggregation dimensions.

200Successful request

curl --request GET \
     --url 'https://app.amberflo.io/usage/current-usage-rate?meterApiName=string&customerId=string' \
     --header 'accept: application/json'