Usage and invoices
Read a meter's usage for a customer, and preview the month's invoice.
Usage
GET /v1/customers/{customer_id}/usage?meter=<key>&from=<date>&to=<date>
returns the meter’s total and a daily breakdown. from is inclusive and to
is exclusive, both UTC dates.
Invoice preview
GET /v1/invoices/preview?customer_id=<id>&period=2026-11 prices the month so
far against the customer’s plan and returns line items, subtotal, and total
in the plan’s currency (ISO 4217).
Price models:
- Tiered: each unit is priced by the tier it falls in.
- Volume: every unit is priced at the tier the total reaches.
- Package: a price per block (for example $5 per 10,000 events).
Totals are rounded half-up to the currency’s minor unit. A customer with no events in the period gets a zero-total preview.