Estimate call cost
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
API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
Query parameters
Destination number, E.164 (leading + optional).
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.
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.
1Responses
Success· the request worked
Errors· the request failed
Get a call recording
Resolves a fresh, playable MP3 URL for the call's recording (provider-signed URLs expire ~10 minutes after signing, so this endpoint re-signs on demand). Default responds `302 Found` redirecting to the fresh URL; pass `as=json` to receive `{ url }` instead.
Mint a browser softphone session
Step 1 of the two-step browser softphone handshake. Mints a WebRTC session (token + credential) the browser registers with the `@telnyx/webrtc` SDK. 1. Call this endpoint and register the browser with the returned session. 2. Once registered, call `POST /v1/voice/calls/web/dial` with the returned `credentialId` to place the call. The split avoids bridging to a browser that has not finished registering. The token lives ~1 hour (it must outlive the whole call, not only the handshake).