Usage
Get usage history
Retrieves historical usage data for a customer's metered feature over time.
get/api/v1/usage/{customerId}/history/{featureId}
Path parameters
customerIdstring required
Customer id
featureIdstring required
Feature id
Query parameters
resourceIdstring nullable
Resource id
startDatestring date-time required
The start date of the range
endDatestring date-time
The end date of the range
groupBystring
Criteria by which to group the usage history
Headers
X-ACCOUNT-IDstring
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
X-ENVIRONMENT-IDstring
Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).
Response
Usage history data points for the specified period.