GET
/v1/billing/metersList billing meters
Lists billing meters that define how meter events are aggregated over a billing period. Use status to filter active or inactive meters and cursor parameters to navigate the results. The response includes meter records and list pagination metadata.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
ending_beforestringoptional
Cursor identifying the first meter on the previous page. Maximum 5,000 characters.
expandarray<string>optional
Fields to expand in the response. Each field name can contain up to 5,000 characters.
limitintegeroptional
Maximum number of meters to return. Must be between 1 and 100 and defaults to 10 when omitted.
starting_afterstringoptional
Cursor identifying the last meter on the previous page. Maximum 5,000 characters.
statusstringoptional
Filter meters by status: `active` or `inactive`.
200Returns a list object containing billing meter records, the `has_more` pagination flag, the list object type, and the resource URL.
dataarray<BillingMeter>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultError response.
errorobjectrequired
Error handling
status must be either active or inactive. ending_before and starting_after must not exceed 5,000 characters, and limit must be between 1 and 100 when supplied.