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 |
|
Yes |
Unique ID identifier of the Trunk. |
Includes#
Name |
Description |
|---|---|
voice_in_trunk_group |
Object Relationships#
Value |
Description |
|---|---|
voice_in_trunk_group |
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}
http
1GET /v3/voice_in_trunks/84746865-b1c0-414d-86c7-62c85c22fd69 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/84746865-b1c0-414d-86c7-62c85c22fd69 -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": "84746865-b1c0-414d-86c7-62c85c22fd69",
7 "type": "voice_in_trunks",
8 "attributes": {
9 "priority": 1,
10 "capacity_limit": 5,
11 "weight": 65535,
12 "name": "Office Mobile",
13 "cli_format": "e164",
14 "cli_prefix": null,
15 "description": null,
16 "ringing_timeout": null,
17 "pop": null,
18 "created_at": "2017-06-25T08:21:41.795Z",
19 "external_reference_id": null,
20 "configuration": {
21 "type": "pstn_configurations",
22 "attributes": {
23 "dst": "1xxxxxxxxx"
24 }
25 }
26 },
27 "relationships": {
28 "voice_in_trunk_group": {
29 "links": {
30 "self": "https://api.didww.com/v3/voice_in_trunks/84746865-b1c0-414d-86c7-62c85c22fd69/relationships/voice_in_trunk_group",
31 "related": "https://api.didww.com/v3/voice_in_trunks/84746865-b1c0-414d-86c7-62c85c22fd69/voice_in_trunk_group"
32 }
33 }
34 }
35 },
36 "meta": {
37 "api_version": "2026-11-19"
38 }
39}
Other Responses#
Code |
Success |
Description |
|---|---|---|
404 |
No |
|
401 |
No |
|
429 |
No |
The request budget of the account for the current window is spent ( |