v2

latestOpenAPI 3.1.02026-08-075421692.0 MB
Usage

Calling usage and cost

Aggregated calling usage across your numbers, both channels (WhatsApp Business Calling + regular phone/PSTN): call counts, answered counts, minutes, and cost. Use it for cost visibility or to rebill your own customers per number.

Costs come from each call's billing snapshot, so this endpoint always agrees with the invoice: billableUSD is what Zernio bills; metaUSD is the WhatsApp per-minute charge Meta bills directly to your WABA (display only, never billed by Zernio).

Optional groupBy returns a breakdown by UTC day, by your number, or by channel. Defaults to the last 30 days.

get/v1/usage/calls

Query parameters

sincestring date-time

Start of the window (inclusive). Default 30 days before until.

untilstring date-time

End of the window (exclusive). Default now.

channel'whatsapp' | 'pstn'
numberstring

Scope to calls involving this number (typically one of YOUR numbers). E.164, leading + optional.

groupBy'day' | 'number' | 'channel'

Response

Usage totals (+ breakdown when groupBy is set).

sincestring date-time
untilstring date-time
groupBy'day' | 'number' | 'channel' | 'null' nullable