Billing Events and Metrics
List billable metrics
Returns a paginated list of billable metrics. Supports filtering by event name, aggregation method, aggregation field, and tag IDs. Results can be sorted by name.
GET
List billable metrics
Authorizations
API key authentication. Pass your API key as a Bearer token.
Headers
Available options:
2026-04-01 Query Parameters
Filter by aggregation field (comma-separated to match any)
Example:
"amount"
Filter by aggregation method (comma-separated to match any)
Available options:
count, count_unique, average, min, max, sum Example:
"sum"
Filter by event name (comma-separated to match any)
Example:
"api_call"
Number of items to return per page
Example:
20
Number of items to skip
Example:
0
Sort field and direction in format field:order
Example:
"name:asc"
Filter by tag IDs (comma-separated to match any)
Example:
"tag_abc123"
Previous
Create a billable metricDefines a new billable metric. A metric specifies the event name, optional filter groups, and aggregation logic that turns raw ingested events into a quantity the billing engine can price against.
Next
List billable metrics