Get credit usage
Retrieves credit usage time-series data for a customer, grouped by feature, over a specified time range.
Query parameters
Maximum number of items to return
Return items that come after this cursor
Return items that come before this cursor
Filter by customer ID (required)
Filter by resource ID
Filter by currency ID
Time range for usage data (LAST_DAY, LAST_WEEK, LAST_MONTH, LAST_YEAR). Defaults to LAST_MONTH
Start date for the credit usage time range (ISO 8601). Takes precedence over timeRange when provided
End date for the credit usage time range (ISO 8601). Defaults to now when startDate is provided
Comma-separated list of feature dimension keys to group usage series by (up to 3). Each key matches /^[a-zA-Z0-9_$-]+$/
Headers
Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.
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
Credit usage data with time-series points per feature.