Pre-1.0 · one maintainer · Stripe and cards only · no SDKs (client libraries) yet · no production users yet. Docs describe v0.9.1 (29 Oct 2026) · What’s new →
The meter object
Fields
Section titled “Fields”| Field | Type | Always present | What it means |
|---|---|---|---|
id |
string | Yes | |
tenant_id |
string | No | |
event_name |
string | Yes | The event_name usage events send for this meter. |
name |
string | Yes | |
unit |
string | Yes | |
aggregation |
enum | Yes | How the meter rolls its events into one quantity per billing period. Every price of the meter bills under it. last is the latest event by timestamp, then by id. Fixed once the meter has a usage event (see has_usage). One of: sum, count, max, last. |
has_usage |
boolean | No | Whether the meter has usage events. Once it has, its aggregation cannot change. Held usage for its event_name does not count until it is released. Returned when you create, get or update one meter; the meter list leaves it out. A create or update that succeeded leaves it out if it could not be read. |
created_at |
string (date-time) | Yes | |
updated_at |
string (date-time) | Yes |