Get Inbound Trunk#

Returns inbound trunks owned by the account. Several type of trunks can be retrieved: SIP, PSTN.

Request#

HTTP Method: GET

URI Path: /v3/voice_in_trunks/{id}

Note

For all returned data attributes, see Inbound Trunk Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID identifier of the Trunk.

Includes#

Name

Description

voice_in_trunk_group

Trunk Group Object

Object Relationships#

Value

Description

voice_in_trunk_group

Trunk Group Object

Examples#

http

1GET /v3/voice_in_trunks/df78e081-b7d1-4769-80ce-f349af4f612e HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]

curl

1curl -i -X GET https://api.didww.com/v3/voice_in_trunks/df78e081-b7d1-4769-80ce-f349af4f612e -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"

response

 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "df78e081-b7d1-4769-80ce-f349af4f612e",
 7    "type": "voice_in_trunks",
 8    "attributes": {
 9      "priority": 1,
10      "capacity_limit": 10,
11      "weight": 2,
12      "name": "Office",
13      "cli_format": "e164",
14      "cli_prefix": "+",
15      "description": null,
16      "ringing_timeout": 30,
17      "pop": null,
18      "created_at": "2017-06-25T08:21:41.795Z",
19      "external_reference_id": null,
20      "configuration": {
21        "type": "sip_configurations",
22        "attributes": {
23          "username": "username",
24          "host": "example.com",
25          "port": null,
26          "codecs": [
27            "pcmu",
28            "g723"
29          ],
30          "rx_dtmf_format_id": 1,
31          "tx_dtmf_format_id": 1,
32          "resolve_ruri": true,
33          "auth_enabled": true,
34          "auth_user": "username",
35          "auth_password": "password",
36          "auth_from_user": "Office",
37          "auth_from_domain": "example.com",
38          "sst_enabled": false,
39          "sst_min_timer": 600,
40          "sst_max_timer": 900,
41          "sst_accept_501": true,
42          "sip_timer_b": 8000,
43          "dns_srv_failover_timer": 2000,
44          "rtp_ping": false,
45          "rtp_timeout": 30,
46          "force_symmetric_rtp": false,
47          "symmetric_rtp_ignore_rtcp": false,
48          "rerouting_disconnect_code_ids": [
49            58,
50            59,
51            1505
52          ],
53          "sst_session_expires": null,
54          "sst_refresh_method_id": 1,
55          "transport_protocol_id": 1,
56          "max_transfers": 5,
57          "max_30x_redirects": 0,
58          "media_encryption_mode": "disabled",
59          "ice_mode": "disabled",
60          "rtcp_mux_mode": "disabled",
61          "rtcp_feedback_mode": "disabled",
62          "stir_shaken_mode": "disabled",
63          "allowed_rtp_ips": null,
64          "network_protocol_priority": "any",
65          "enabled_sip_registration": false,
66          "use_did_in_ruri": false,
67          "incoming_auth_username": null,
68          "incoming_auth_password": null,
69          "diversion_relay_policy": "as_is",
70          "diversion_inject_mode": "did_number",
71          "cnam_lookup": true
72        }
73      }
74    },
75    "relationships": {
76      "voice_in_trunk_group": {
77        "links": {
78          "self": "https://api.didww.com/v3/voice_in_trunks/df78e081-b7d1-4769-80ce-f349af4f612e/relationships/voice_in_trunk_group",
79          "related": "https://api.didww.com/v3/voice_in_trunks/df78e081-b7d1-4769-80ce-f349af4f612e/voice_in_trunk_group"
80        }
81      }
82    }
83  },
84  "meta": {
85    "api_version": "2026-11-19"
86  }
87}

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized

429

No

The request budget of the account for the current window is spent (too_many_requests). Retry-After gives the number of seconds to wait.