Usage

Calling usage and cost

Changed on

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/usage/calls
  • Auth: HTTP bearer

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

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status