DOCS · v2026.04
The docs are the contract.
No marketing fluff. Just the protocols, payloads, endpoints, and timing guarantees — written by the people who run the network.
GET / GETTING STARTED15 MINUTES · FROM SIGN-UP TO FIRST CALL
The first-trunk path.
LIVE
[●]GET.01Your first trunk in 15 minutes— Trunk ID, credentials, IP-auth, first call placed.2 min[○]GET.02FreeSWITCH · Asterisk · Kamailio— Working config snippets for the usual suspects.4 min[○]GET.03TLS + SRTP— Opt-in end-to-end encryption on any trunk.3 min[○]GET.04Your first 100 calls— Watch them stream through the CDR pipe.1 min
$ walkthrough · tail -f
→ signup accepted · trunk_id=t_824f19
→ whitelist added · 203.0.113.42/32
→ first INVITE · sip:+14155551212
✓ 200 OK · signed A · pdd 1.72s
→ CDR posted · ws://cdr.vicicarrier.com
all green · elapsed 00:13:42
RTE / ROUTING & DIALPLANSHOW CALLS LEAVE US
Least-cost routing is a score, not a lookup.
Every call is ranked across four carriers at each POP. Here's the scoring function — published, not proprietary.
rankcarriercostASRPDDscore
#01◄tier-1 · upstream-a$0.008268.2%1.64s94.7
#02tier-1 · upstream-b$0.007966.9%1.81s92.3
#03tier-2 · upstream-c$0.007464.1%2.02s88.1
#04tier-3 · upstream-d$0.007161.3%2.41s82.4
→ score = (0.4 × cost_rank) + (0.35 × ASR_7d) + (0.15 × PDD_p50) + (0.10 × post_answer_quality). Recomputed every 30s per destination.
BIL / BILLING & CDRTHE INVOICE IS THE SOURCE OF TRUTH
Published fields. Machine-readable. No surprises.
INVOICE · 2026-04
INV-2026-04-0824F
PAID
US termination4,281,042 min × $0.0100$42,810.42
MX termination890,104 min × $0.0160$14,241.66
DIDs · 240 × $5Tier A · US/CA$1,200.00
DIDs · 12 × $10Tier B · MX/BR$120.00
volume discount−8% · prepay tier−$4,650.97
total due$53,721.11
BIL.01
CDR stream
WebSocket push or REST pull. 30ms median delay from call end to record.
BIL.02
Rate deck JSON
Machine-readable rate sheet. Versioned. GET /v1/rates.
BIL.03
Disputes
Paste the CDR row. Credited within 2 business days or we eat it.
BIL.04
Prepay credits
Wire $10k+ up-front for −8%. Reconciled monthly, unspent rolls.
API / REFERENCEPROGRAMMATIC
Four endpoints cover 90% of the work.
# provision a number
POST /v1/numbers {"npa":"415","count":10}
# get a quote from a CDR
POST /v1/quote multipart/form-data; [email protected]
# pull CDR for a timespan
GET/v1/cdr?from=2026-04-01&to=2026-04-17
# the rate deck, machine-readable
GET /v1/rates
Full OpenAPI spec + interactive console live at portal.vicicarrier.com/docs after sign-in.
BUILD FAST · SCALE LATER
Get a trunk ID, send INVITEs.
Trunk provisioning is the same call as signup. From there everything is REST, WebSocket, or SIP — pick whatever your stack prefers.