VoxLink.ai

API Reference

Get SIP trunk

Get a single SIP trunk by ID

Updated 30 June 2026

This endpoint returns detailed information about a specific SIP trunk, including internal trunk IDs useful for debugging.

Path Parameters

idintegerrequired

The unique identifier of the SIP trunk

Response

dataobject

The SIP trunk object

idinteger

  The unique identifier of the SIP trunk

phone_numberstring

  The SIP extension or phone number (DID) in E.164 format

nicknamestring

  A short, human-friendly label for the trunk (or `null` if not set)

sip_usernamestring

  The username used for SIP authentication

sip_addressstring

  The SIP server address

sip_calling_formatstring

  The outbound calling number format: `+e164`, `e164`, or `national`

inbound_authorization_typestring

  The inbound authorization method: `auth` or `ip`

allowed_inbound_ipsarray

  Array of whitelisted IP addresses (only when `inbound_authorization_type` is `ip`)

outbound_proxyboolean

  Whether outbound calls use a fixed proxy IP address

country_codestring

  The ISO 3166-2 country code

inbound_trunk_idstring

  Internal identifier for the inbound voice trunk (useful for debugging)

outbound_trunk_idstring

  Internal identifier for the outbound voice trunk (useful for debugging)

created_atstring

  ISO 8601 timestamp

updated_atstring

  ISO 8601 timestamp
{
  "data": {
    "id": 42,
    "phone_number": "1000",
    "nickname": "Provider X — Main",
    "sip_username": "myuser",
    "sip_address": "sip.provider.com",
    "sip_calling_format": "+e164",
    "inbound_authorization_type": "auth",
    "allowed_inbound_ips": null,
    "outbound_proxy": false,
    "country_code": "US",
    "inbound_trunk_id": "ST_xxxxxxxxxxxx",
    "outbound_trunk_id": "ST_yyyyyyyyyyyy",
    "created_at": "2026-03-31T10:00:00.000000Z",
    "updated_at": "2026-03-31T10:00:00.000000Z"
  }
}
{
  "error": "SIP trunk not found."
}

Related guides