Skip to main content
GET
/
sip-trunks
/
trunks
cURL
curl --request GET \
  --url https://api.bolna.ai/sip-trunks/trunks \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "provider": "<string>",
    "description": "<string>",
    "auth_type": "userpass",
    "auth_username": "<string>",
    "gateways": [
      {
        "gateway_address": "sip.zadarma.com",
        "port": 5060,
        "priority": 1
      }
    ],
    "ip_identifiers": [
      {
        "ip_address": "15.207.90.192/31"
      }
    ],
    "phone_numbers": [
      {
        "id": "<string>",
        "phone_number": "<string>",
        "name": "<string>",
        "byot_trunk_id": "<string>",
        "telephony_provider": "sip-trunk",
        "deleted": true,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "allow": "<string>",
    "disallow": "<string>",
    "transport": "<string>",
    "direct_media": true,
    "rtp_symmetric": true,
    "force_rport": true,
    "ice_support": true,
    "qualify_frequency": 123,
    "inbound_enabled": true,
    "outbound_leading_plus_enabled": true,
    "is_active": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
]
SIP Trunking is currently in Beta.

Please reach out to us at enterprise@bolna.ai or schedule a call at https://www.bolna.ai/meet for more information and access.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
is_active
boolean

Filter by active status. Omit to return all trunks.

Response

List of SIP trunks

​
id
string

Unique SIP trunk identifier.

​
name
string

Human-readable trunk name.

​
provider
string

SIP provider name (e.g., twilio, plivo, zadarma, telnyx, vonage, custom).

​
description
string

Optional trunk description for internal reference.

​
auth_type
enum<string>

Authentication method used for this trunk.

Available options:
userpass,
ip-based
​
auth_username
string

SIP username (present only for userpass trunks).

​
gateways
object[]

Ordered list of SIP gateways used for registration and call routing.

​
ip_identifiers
object[]

IP ranges associated with this trunk (used only for ip-based authentication).

​
phone_numbers
object[]

Phone numbers (DIDs) registered on this trunk.

​
allow
string

Comma-separated codecs to allow.

​
disallow
string

Comma-separated codecs to disallow.

​
transport
string

SIP transport used by the trunk.

​
direct_media
boolean

Whether RTP is routed directly between endpoints (typically false).

​
rtp_symmetric
boolean

Enables symmetric RTP to handle NAT.

​
force_rport
boolean

Forces responses to the source port to handle NAT.

​
ice_support
boolean

Whether ICE is enabled for media negotiation.

​
qualify_frequency
integer

SIP OPTIONS ping interval in seconds.

​
inbound_enabled
boolean

Whether inbound calling is enabled.

​
outbound_leading_plus_enabled
boolean

Whether to prepend a leading + to outbound dialed numbers.

​
is_active
boolean

Whether the trunk is active.

​
created_at
string<date-time>

ISO timestamp when the trunk was created.

​
updated_at
string<date-time>

ISO timestamp when the trunk was last updated.