Skip to main content
GET
Get SIP trunk

Authorizations

Authorization
string
header
required

Send your organization API key as Authorization: Bearer <key>.

Path Parameters

id
string<uuid>
required

SIP trunk id

Response

SIP trunk

SIP connectivity profile for a supported PBX integration.

id
string<uuid>
created_at
string<date-time>
pbx
enum<string>

PBX vendor preset (3cx, yeastar, webex) applying default trunk behavior, or generic for other / custom PBX setups where you supply hosts and credentials explicitly.

Available options:
3cx,
yeastar,
webex,
generic
region
enum<string>

Vatel telephony region that should own this trunk's SIP edge. Set this to match the hostname you use when sending SIP to Vatel or pointing your PBX at Vatel: us-central1 for us-central1.sip.vatel.ai, northamerica-northeast1 for northamerica-northeast1.sip.vatel.ai. sip.vatel.ai is a convenience alias for US Central, not a third region. Defaults to us-central1 when omitted. Outbound SIP REGISTER originates from the selected region; inbound routing is not fully region-locked by this field yet.

Available options:
us-central1,
northamerica-northeast1
caller_id_transforms
object[]

Ordered transforms applied to caller id.

inbound_host
string

Inbound SIP host or domain. When inbound_auth_type is acl, this is the host validated against the ACL (allowed source for inbound calls).

inbound_auth_type
enum<string>

How inbound SIP is authenticated. acl: carrier traffic must match the ACL; inbound_host is the ACL-validated host. digest: SIP digest authentication. none: no inbound auth configured.

Available options:
digest,
acl,
none
inbound_sip_username
string

SIP user for inbound registration if used.

inbound_registration_status
enum<string>

Last known SIP registration outcome for the trunk leg.

Available options:
not_registered,
pending,
registered,
failed,
auth_failed
outbound_host
string

SIP host used for outbound legs: platform-initiated calls, on-call flows, and transfers dial out via this host (your carrier or SBC).

outbound_sip_username
string

Credentials username for outbound, if any.

register
boolean

Whether the platform registers this trunk with the carrier.

outbound_registration_status
enum<string>

Last known SIP registration outcome for the trunk leg.

Available options:
not_registered,
pending,
registered,
failed,
auth_failed
remain_in_dialog
boolean

Keeping SIP dialog routing behavior when true.