# 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](voice-in-trunk-object.html).

### 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](../voice-in-trunk-groups/trunk-group-object.html#voice-in-trunk-group-object-v35) |

### Object Relationships

| Value | Description |
| --- | --- |
| voice\_in\_trunk\_group | [Trunk Group Object](../voice-in-trunk-groups/trunk-group-object.html#voice-in-trunk-group-object-v35) |

## Examples

SIP TrunkPSTN

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

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}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 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. |
