Balance
GET /v1/billing/balance
200 — Current balances:
| Field | Meaning |
|---|---|
| free | Immediately spendable |
| reserved | Held for in-flight operations |
| total | Accounting total (free + reserved semantics per product) |
200 — response fields
Immediately spendable balance.
Held for in-flight operations (for example message holds).
Accounting total; semantics match product policy for free + reserved.
Usage and tier
GET /v1/billing/usage
Query:
YYYY-MM — defaults to current month.GET /v1/billing/usage/detailed
Query
Start date (ISO date).
End date (ISO date).
Optional grouping: message type, channel, etc.
GET /v1/billing/tier
200 — Current tier per channel (email, RCS, SMS are tracked independently), qualification source, and downgrade counter where applicable. Use the optional channel query parameter to filter to a specific channel’s tier.
Top-ups and payment methods
POST /v1/billing/topup
Initiates a payment for prepaid balance. Body includes amount (minimum €10), currency (EUR), and the payment_method_id from your stored payment methods.
GET / POST /v1/billing/payment-methods
List or add card / SEPA methods as supported.
Auto-reload and alerts
GET / PUT /v1/billing/auto-reload
Read or set threshold and reload amount for automatic top-up.
PUT /v1/billing/alerts
Configure cost alerts; fires billing.balance_low webhooks when crossed.
Ledger and invoices
GET /v1/billing/transactions
Query — cursor, limit, from (ISO date), to (ISO date). Returns charges, top-ups, releases, credits.
GET /v1/billing/invoices
Monthly invoice rows; PDF download URLs when present.
Relationship to sends
EveryPOST /v1/messages success includes inline billing. These routes power dashboards, reconciliation, and automation.
Billing units (Learn)
Basic, Single, Conversation, MAU, and tier volume.
Billing (RCS)
RCS Basic/Single, conversation, MAU.
Billing (Email)
Email Basic Message and email-specific tier.
Errors
HTTP 402 and client handling.