Docs

Everything you need, nothing you don't.

Short, opinionated guides with real cURL and code. No 30-minute video walkthroughs.

Coming soon · The written guides below are in progress. Everything they'll cover is already doable from the console — and support@siptrunx.io answers fast.

Get started

  • Buy your first number

    From signup to a real PSTN call in five minutes.

  • Set up a SIP trunk

    Register your PBX or softphone against the switch.

  • Receive your first call

    mod_xml_curl, dialplan, and how routing decisions work.

Numbers

  • Search and buy DIDs

    Filter by country, area code, type, features.

  • Port a number in

    LOA flow, FOC dates, what to expect.

  • Release or transfer

    Cleanly hand a DID back to the pool.

  • Reputation & STIR/SHAKEN

    How we score numbers and remediate flags.

Calls

  • Routing rules

    Primary + failover, time-of-day, blacklist.

  • Voicemail & IVR

    Greetings, transcription, auto-attendant trees.

  • Recording & retention

    S3 storage, encryption, consent.

API

  • REST reference

    /numbers, /trunks, /cdrs, /webhooks.

  • Webhooks

    Event types, retries, replay, and HMAC-SHA256 signing — verify the canonical X-SIPTrunx-Signature header.

  • Authentication

    API keys, scopes, rotation.

Billing

  • How rating works

    Per-second granularity after first 6 seconds.

  • Invoices & taxes

    GST / VAT, tax-exempt status.

  • Top-up & auto-recharge

    Stripe + Razorpay; pick by country.

Quickstart

# Buy a number
curl -X POST https://api.siptrunx.io/v1/numbers \
  -H "Authorization: Bearer ${SIPTRUNX_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "country": "US", "type": "local", "area_code": "415" }'

# → 201
{
  "id": "did_01HFVZ...",
  "number": "+14155550142",
  "status": "assigned",
  "monthly_cost": 1.00,
  "inbound_rate": 0.0085
}

# Point it at your trunk
curl -X PATCH https://api.siptrunx.io/v1/numbers/did_01HFVZ... \
  -H "Authorization: Bearer ${SIPTRUNX_KEY}" \
  -d '{ "destination": "sip:acme@pbx.example.com:5060" }'