# Get SMS Trunk

Returns a single SMS trunk owned by the account.

On an `http_out` trunk, `meta.host` contains the full URL of the endpoint to which outbound
messages are submitted.

## Request

HTTP Method: `GET`

URI Path: `/v3/sms_trunks/{id}`

Note

For all returned data attributes, see [SMS Trunk Object](sms-trunk-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique identifier of the SMS trunk. |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| fields[sms\_trunks] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |

### Includes

| Value | Description |
| --- | --- |
| outgoing\_dids | [DID Object](../did/did-object.html#did-object-v35). DIDs allowed as the source address of outbound messages. |
| incoming\_dids | [DID Object](../did/did-object.html#did-object-v35). DIDs routed to the trunk for inbound messages. |
| sms\_trunk\_group | [SMS Trunk Group Object](../sms-trunk-groups/sms-trunk-group-object.html#sms-trunk-group-object-v35) |
| sender\_id\_verifications | [Sender ID Verification Object](../sender-id-verifications/sender-id-verification-object.html#sender-id-verification-object-v35). Sender ID verifications routed through the trunk. |

## Examples

HTTP OUT TrunkIncluded SMS Trunk Group

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13 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/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13 -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": "6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13",
 7    "type": "sms_trunks",
 8    "attributes": {
 9      "name": "Outbound HTTP",
10      "external_reference_id": null,
11      "blocked": false,
12      "priority": null,
13      "allow_any_did_as_source": false,
14      "allow_in": false,
15      "allow_out": true,
16      "created_at": "2026-10-22T09:15:42.118Z",
17      "updated_at": "2026-10-22T09:15:42.118Z",
18      "configuration": {
19        "type": "http_out",
20        "attributes": {
21          "callback_url": "https://example.com/sms/status",
22          "allowed_ips": [
23            "203.0.113.10/32"
24          ],
25          "auth_name": "k3v9xq2m7p",
26          "auth_password": "w8r2c5n1zt"
27        }
28      }
29    },
30    "relationships": {
31      "outgoing_dids": {
32        "links": {
33          "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/outgoing_dids",
34          "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/outgoing_dids"
35        }
36      },
37      "incoming_dids": {
38        "links": {
39          "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/incoming_dids",
40          "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/incoming_dids"
41        }
42      },
43      "sms_trunk_group": {
44        "links": {
45          "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/sms_trunk_group",
46          "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/sms_trunk_group"
47        }
48      },
49      "sender_id_verifications": {
50        "links": {
51          "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/sender_id_verifications",
52          "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/sender_id_verifications"
53        }
54      }
55    },
56    "meta": {
57      "host": "https://us.sms-out.didww.com/outbound_messages"
58    }
59  },
60  "meta": {
61    "api_version": "2026-11-19"
62  }
63}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67?include=sms_trunk_group 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/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67?include=sms_trunk_group' -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": "8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67",
 7    "type": "sms_trunks",
 8    "attributes": {
 9      "name": "SMPP ESME",
10      "external_reference_id": null,
11      "blocked": false,
12      "priority": 100,
13      "allow_any_did_as_source": false,
14      "allow_in": true,
15      "allow_out": true,
16      "created_at": "2026-10-22T09:15:42.118Z",
17      "updated_at": "2026-10-22T09:15:42.118Z",
18      "configuration": {
19        "type": "smpp_esme",
20        "attributes": {
21          "allowed_ips": [
22            "203.0.113.10/32",
23            "198.51.100.0/24"
24          ],
25          "system_id": "a7k2m9x4",
26          "system_type": null,
27          "password": "p3z8q1w6",
28          "server_location": "nyc"
29        }
30      }
31    },
32    "relationships": {
33      "outgoing_dids": {
34        "links": {
35          "self": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/relationships/outgoing_dids",
36          "related": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/outgoing_dids"
37        }
38      },
39      "incoming_dids": {
40        "links": {
41          "self": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/relationships/incoming_dids",
42          "related": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/incoming_dids"
43        }
44      },
45      "sms_trunk_group": {
46        "links": {
47          "self": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/relationships/sms_trunk_group",
48          "related": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/sms_trunk_group"
49        },
50        "data": {
51          "type": "sms_trunk_groups",
52          "id": "c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46"
53        }
54      },
55      "sender_id_verifications": {
56        "links": {
57          "self": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/relationships/sender_id_verifications",
58          "related": "https://api.didww.com/v3/sms_trunks/8e4b2c6a-9d1f-4a3e-b7c5-5f0d2e8a1b67/sender_id_verifications"
59        }
60      }
61    }
62  },
63  "included": [
64    {
65      "id": "c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46",
66      "type": "sms_trunk_groups",
67      "attributes": {
68        "name": "Inbound SMS",
69        "external_reference_id": null,
70        "created_at": "2026-10-22T09:15:42.118Z",
71        "updated_at": "2026-10-22T09:15:42.118Z"
72      },
73      "relationships": {
74        "sms_trunks": {
75          "links": {
76            "self": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/relationships/sms_trunks",
77            "related": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/sms_trunks"
78          }
79        },
80        "incoming_dids": {
81          "links": {
82            "self": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/relationships/incoming_dids",
83            "related": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/incoming_dids"
84          }
85        }
86      },
87      "meta": {
88        "sms_trunks_count": 2
89      }
90    }
91  ],
92  "meta": {
93    "api_version": "2026-11-19"
94  }
95}
```

[[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. |
