Zernio
APIFor you
Zernio
APIFor you
Platforms

Voice & Calls

Overview

Set up

Setup
Integrations
ElevenLabsRetell

Calls

AI Voice AgentsOutbound CallsBrowser CallingCall History & Recordings

Reference

Limits & Errors
Dashboard
OverviewPlatformsAPI ReferenceResources
Voice & Calls

Limits & Errors

Voice call limits, what calling and SIP trunks cannot do, and the errors you will meet when routing and placing calls, each with its fix.


Limits

LimitValue
Outbound calls60 per rolling hour, counted across every number on your key
Business hoursAt most 21 windows
IVR menuAt most 12 options; digits 0 to 9, * or #
Ringing before voicemailAbout 25 seconds
Voicemail messageUp to 2 minutes
Recording URLSigned, expires about 10 minutes after signing
Browser session tokenLives about 1 hour and must outlive the call
Media stream (wss://)PCMU (G.711 u-law) at 8 kHz in both directions, not configurable per number
SIP trunk caps10 concurrent calls, a daily spend ceiling, a per-minute destination-rate cap, a destination country whitelist
Recording and transcriptionOff by default; +$0.004 and +$0.03 per minute

What you cannot do

Voice on Zernio does not allow:

  • Transferring a call to a wss:// target (use a +E164 number or a sip: URI)
  • Calling emergency services (112/911)
  • Routing calls on a number that lives on your own carrier (brought in through WhatsApp embedded signup)
  • Zernio voice features (forwarding, IVR, voicemail, recording, softphone) on a number attached to a SIP trunk
  • Attaching a number to a SIP trunk while Calls or WhatsApp calling is on
  • WhatsApp Business Calling on a SIP trunk
  • Agent-initiated outbound calls on the forwarding lane (use a SIP trunk)
  • Adding your own headers to the forwarded SIP INVITE
  • Presenting a caller ID through a trunk that is not hosted on, or verified onto, your team
  • A recording for a call that started without recording on
  • A separate voicemail webhook
  • call.received on outbound phone calls
  • A price quote for inbound calls (the estimate covers outbound destinations only)
  • TLS signaling or SRTP media on Retell's inbound leg (its ingest is TCP)

Common errors

StatusCodeCauseFix
422No voice-enabled number matches fromNumber, or the number has no forward destination and the call sent no forwardToSet the forward destination, or pass forwardTo
429The outbound cap of 60 calls per rolling hour was hitWait for the rolling hour; the message has the current cap
409A transfer on a call that is not connected yet or already endedTransfer only while the call is live
502The carrier refused to originate; the call is marked failedRetry the call
422A browser dial with an unknown or expired credentialId, or no voice-enabled number matches fromNumberMint a new session and register it before dialing
409invalid_resource_stateVoice settings on a number attached to a SIP trunkDetach it with DELETE /v1/phone-numbers/{id}/sip-trunk
422Voice settings on a number that lives on your own carrierUse a number bought or ported into Zernio
409invalid_resource_stateA trunk attach on a number with Calls or WhatsApp calling on, mid WhatsApp verification, or not activeCall DELETE /v1/phone-numbers/{id}/voice, disable WhatsApp calling, then attach
403feature_not_availableCreating a SIP trunk on legacy (non-usage-based) billingMove the workspace to usage-based billing
404A recording for a call that does not exist under your key or has no recordingCheck recordingEnabled on the call record
502The recording provider lookup failedRetry

A wss:// agent that hangs up or falls to voicemail right after answering usually means the stream handshake failed. Read callErrors on the call record.

An ElevenLabs call that connects and drops at once is almost always a + mismatch between the import and the forwardTo URI.

Every error uses the envelope in error handling.

Related

  • Setup: forwarding, voicemail, business hours, IVR and blocklist.
  • Outbound calls: place, transfer and end calls.
  • AI voice agents: sip: and wss:// destinations.
  • ElevenLabs: SIP forwarding, trunks and the technical FAQ.
  • Call rates: per-minute prices by destination.
Was this page helpful?

Call History & Recordings

List every call across your numbers and both channels with GET /v1/calls, open one call, and fetch a fresh recording URL.

SMS

Send and receive SMS and MMS from your numbers with POST /v1/sms/messages, with US carrier registration handled through the API.

On this page

LimitsWhat you cannot doCommon errorsRelated