OverviewPlatformsAPI ReferenceResources
Voice & Calling

Estimate call cost

GEThttps://zernio.com/api/v1/voice/calls/estimate

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.

Authentication

AuthorizationBearer tokenRequired

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

Query parameters

tostringRequired

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.

minutesintegerDefault 1
recordingboolean
transcriptionboolean

Responses

Success· the request worked

Errors· the request failed

GET/v1/voice/calls/estimate
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.voice.getVoiceCallEstimate({  query: {    to: 'string',  },});console.log(data);
{  "destinationCountry": "string",  "minutes": 0,  "perMinuteUsd": 0,  "breakdown": {    "telnyxCostUSD": 0,    "recordingCostUSD": 0,    "transcriptionCostUSD": 0,    "brandedCallUSD": 0,    "billableCostUSD": 0,    "totalCostUSD": 0  }}
OpenAPI specification
Was this page helpful?