ZEzernio
Voice

Estimate call cost

Changed on

Pre-call cost estimate for a PSTN call: the carrier leg plus optional recording and transcription add-ons.

It uses the same billing formula as the post-call invoice, so the quote and the final charge can't disagree.

The carrier figure follows the carrier's per-destination rate card: a call dialed from a number in the destination country uses the local mobile rate, and a tel: forward destination is quoted as a second carrier leg billed from the same number.

The real cost comes from the settled carrier record after the call.

Parity endpoint of GET /v1/whatsapp/calls/estimate, minus the Meta line. PSTN calls have no separate Meta bill, so totalCostUSD equals billableCostUSD.

get/v1/voice/calls/estimate

Request

Query parameters

tostring required

Destination number, E.164 (leading + optional).

fromstring

The number the call would dial from, E.164. When it is verified on a Branded Calling identity and to is a US number, the estimate includes the per-call Branded Calling surcharge.

forwardTostring

Destination the call bridges to: tel:+E164, sip:... or wss://.... Defaults to the dialing number's configured forward. A tel: destination adds a second carrier leg to the quote. Encode the + as %2B.

minutesinteger
recordingboolean
transcriptionboolean

Response

Estimate

destinationCountrystring nullable
minutesinteger
perMinuteUsdnumber

Billable cost per minute for the requested options.

Changes