Skip to content

Get a SIP trunk

GET
/v1/trunks/{trunk}
curl --request GET \
--url https://api.caller9.app/v1/trunks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Returns a trunk, including its SIP credentials and the numbers routed to it.

trunk
required
string format: uuid

SIP trunk ID (UUID).

The trunk.

Media typeapplication/json
object
trunk
required

A SIP trunk your PBX registers to. Includes registration credentials — sip_password is a secret; store it securely and never log it.

object
guid
required
string
organization_guid
required
string
name
required
string
sip_username
required

SIP registration username.

string
sip_password
required

SIP registration password (secret). Changes when rotated.

string
sip_uri
required

The trunk’s SIP URI (sip:<username>@sip.telnyx.com).

string
default_cid_number_guid
required

ID of the organization number used as the default outbound caller ID.

string | null
cid_display_name
required

Outbound caller ID name (CNAM); empty if unset.

string
channel_limit
required

Maximum concurrent calls; null = unlimited.

integer | null
localization
required

ISO 3166-1 alpha-2 country code (default US).

string
numbers
required

Numbers routed to this trunk for inbound calls, sorted by number.

Array<object>
object
guid
required
string
number
required

E.164 phone number.

string
name
required
string
created_at
required
string format: date-time
updated_at
required
string format: date-time

Example generated

{
"trunk": {
"guid": "example",
"organization_guid": "example",
"name": "example",
"sip_username": "example",
"sip_password": "example",
"sip_uri": "example",
"default_cid_number_guid": "example",
"cid_display_name": "example",
"channel_limit": 1,
"localization": "example",
"numbers": [
{
"guid": "example",
"number": "example",
"name": "example"
}
],
"created_at": "2026-04-15T12:00:00Z",
"updated_at": "2026-04-15T12:00:00Z"
}
}

Missing, invalid, expired or revoked API key.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Not found, or belongs to another organization.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}

Too many requests for this API key. Retry after Retry-After seconds.

Media typeapplication/json
object
error
required

Human-readable error message.

string
code

Machine-readable code (authentication failures only, e.g. KEY_EXPIRED, RATE_LIMITED).

string

Example generated

{
"error": "example",
"code": "example"
}
Retry-After
integer

Seconds until the rate-limit window resets.