Tone docs
API referencesip-trunks

One SIP trunk

The trunk as it stands, including the last connectivity test.

Open in ClaudeOpen in ChatGPTView as Markdown

Requires the read scope. A key with less gets 403 insufficient_scope.

GET
/v1/sip-trunks/{id}

Authorization

AuthorizationBearer <token>

Authorization: Bearer tone_live_… or tone_test_…. The prefix IS the environment: a test key reaches only the sandbox, and no request field bridges the two.

In: header

Path Parameters

id*string

The SIP trunk's id.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/sip-trunks/string"
{  "data": {    "allowOrigination": false,    "approvedAt": "2026-09-09T11:00:00Z",    "callerIdPolicy": "did",    "codecs": [      "PCMA",      "PCMU"    ],    "connection": {      "host": "sip.usetone.ai",      "ips": [        "13.233.10.20"      ],      "port": 5061,      "transport": "tls"    },    "createdAt": "2026-09-09T10:14:22Z",    "customHeaders": {},    "digestUsername": "t_9f2c4a7b1d3e5f60",    "disabledReason": null,    "hasOutboundPassword": true,    "id": "4b7c1a02-9de5-4f31-bb07-2c1a5e9f0d43",    "inboundAuth": "digest",    "ipAcl": [      "49.207.12.0/24"    ],    "lastInboundAt": "2026-09-10T08:12:44Z",    "lastOutboundAt": null,    "lastProbe": {      "at": "2026-09-10T08:12:44Z",      "error": null,      "latencyMs": 41,      "method": "options",      "ok": true,      "sipStatus": 200    },    "maxConcurrent": 10,    "name": "Airtel SIP — Mumbai office",    "outboundAuthUsername": "acme-out",    "outboundHost": "sbc.acme-telecom.example",    "outboundNumberFormat": "e164",    "outboundPort": 5061,    "outboundTransport": "tls",    "realm": "sip.usetone.ai",    "register": false,    "status": "active",    "updatedAt": "2026-09-10T08:12:44Z"  }}
Was this page helpful?

Connect your own carrier over SIP — credentials are shown once

Creates a trunk in pending_verification: you can configure and test it, and our team approves it before it carries calls. Requires completed business verification AND SIP trunking enabled on your organization (403 sip_trunking_not_enabled otherwise — contact support). 🔴 The digest password in connection.password appears in this response only. Send an Idempotency-Key to make a retried create return the same trunk and the same password.

Import a number you own at your carrier onto this trunk

Tone learns to answer for a DID your carrier already delivers to this trunk. Nothing is bought and no rental is charged. The number appears in GET /v1/numbers with provider: sip_trunk, and is released like any other — release stops answering; it does not touch your carrier. 409 if the number is live anywhere on Tone.