Documentation

Everything you need to integrate in an afternoon.

Concrete SIP examples, endpoint URLs, sample dialplans and a full API reference. Written by engineers, not by marketing.

Getting started

  1. 1. Create an account at voxiotelecom.com/auth. No KYC for accounts up to $500/month.
  2. 2. Top up in crypto — go to Portal → Funds and generate a payment. We support BTC, USDT-TRC20 and ETH. Balance credits automatically after 1 confirmation (BTC) or instant for TRC20.
  3. 3. Create a SIP trunk from Portal → SIP Trunks. Choose IP auth (paste your PBX public IP) or user/password.
  4. 4. Point your PBX at sip.voxiotelecom.com:5060 and start calling.

SIP trunk setup

Endpoints

SIP host
sip.voxiotelecom.com
SIP port (UDP/TCP)
5060
SIP port (TLS)
5061
RTP range
10000-20000/UDP
Registrar
sip.voxiotelecom.com

Number format

Always dial in E.164 without the leading +.

  • 4930901820 → Germany, Berlin
  • 12125551234 → USA, NYC
  • 18005551234 → USA Toll-Free

Sample Asterisk (pjsip.conf)

[voxio]
type=endpoint
transport=transport-udp
context=from-voxio
disallow=all
allow=alaw,ulaw,g729
outbound_auth=voxio-auth
aors=voxio-aor
from_user=YOUR_SIP_USER
from_domain=sip.voxiotelecom.com
direct_media=no

[voxio-auth]
type=auth
auth_type=userpass
username=YOUR_SIP_USER
password=YOUR_SIP_PASSWORD

[voxio-aor]
type=aor
contact=sip:sip.voxiotelecom.com:5060

Authentication modes

IP whitelist (recommended)

Best for carriers, PBXes and dedicated SBCs with a static public IP. No registration needed — we authenticate calls by source IP.

You can whitelist up to 10 IPs per trunk.

Username / password

Good for softphones, dev environments or PBXes behind NAT with dynamic IPs. Uses SIP digest auth.

Credentials are generated when you create the trunk — visible only once.

Codecs & media

Supported codecs, in preference order: G.711 A-law, G.711 µ-law, G.729, Opus. DTMF is negotiated as RFC 2833 (out-of-band) by default; SIP INFO available on request.

SRTP over TLS is available on port 5061 for privacy-sensitive deployments. Media is anchored on our SBC; direct media is disabled.

Billing & top-up

Prepaid, per-second billing with no rounding penalty (1s minimum, 1s increment). Every call generates a CDR available in Portal → CDRs and via API.

Top up in Bitcoin, USDT (TRC20) or Ethereum. Payments are processed by Plisio; funds are credited to your MBilling balance automatically once the transaction confirms on-chain.

Auto-topup can be enabled from Portal → Funds → Auto-topup — we generate a fresh crypto invoice whenever your balance falls below the threshold you set.

Rate deck

Rates are quoted in USD per minute and use longest-prefix matching. Routes are classified as either Standard or Premium CLI — the latter guarantees caller ID delivery contractually.

Rate changes are notified 7 days in advance for decreases and 14 days in advance for increases. Historical rate decks are available on request.

REST API

Generate an API key from Portal → API Keys. Requests are authenticated via Authorization: Bearer <secret>.

Endpoints

  • GET /api/v1/balance
  • GET /api/v1/rates?prefix=49
  • GET /api/v1/cdrs?from=2026-01-01&to=2026-01-31
  • POST /api/v1/topup  (crypto invoice)

Full OpenAPI spec available on request — email api@voxiotelecom.com.

Troubleshooting

403 Forbidden

Source IP not whitelisted on the trunk, or userpass credentials wrong.

404 Not Found

Number not in E.164 (leading + or missing country code).

402 Payment Required

Insufficient balance. Top up in Portal → Funds.

503 Service Unavailable

All routes to that destination are temporarily degraded. Retry or open a ticket.

486 Busy Here

Called party is busy — pass-through from the destination carrier.

487 Request Terminated

Caller hung up before the call was answered.

Still stuck? Open a ticket at Portal → Support or email noc@voxiotelecom.com. NOC is 24/7.

See the live rate deck

Create an account to browse the full A-Z deck in your portal — Premium CLI and Standard clearly labelled, searchable by prefix or destination.

Create account