Get SMS Trunk Group#

Returns a single SMS trunk group owned by the account.

Request#

HTTP Method: GET

URI Path: /v3/sms_trunk_groups/{id}

Note

For all returned data attributes, see SMS Trunk Group Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique identifier of the SMS trunk group.

include

string

No

Inclusion

fields[sms_trunk_groups]

string

No

Sparse fieldsets

Includes#

Value

Description

sms_trunks

SMS Trunk Object. The trunks in the group.

incoming_dids

DID Object. DIDs routed to the group for inbound messages.

Example#

http

1GET /v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46 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_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46 -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": "c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46",
 7    "type": "sms_trunk_groups",
 8    "attributes": {
 9      "name": "Inbound SMS",
10      "external_reference_id": null,
11      "created_at": "2026-10-22T09:15:42.118Z",
12      "updated_at": "2026-10-22T09:15:42.118Z"
13    },
14    "relationships": {
15      "sms_trunks": {
16        "links": {
17          "self": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/relationships/sms_trunks",
18          "related": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/sms_trunks"
19        }
20      },
21      "incoming_dids": {
22        "links": {
23          "self": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/relationships/incoming_dids",
24          "related": "https://api.didww.com/v3/sms_trunk_groups/c5e7a9b1-6d3f-4f2a-8c4e-9b1d7f3a5e46/incoming_dids"
25        }
26      }
27    },
28    "meta": {
29      "sms_trunks_count": 2
30    }
31  },
32  "meta": {
33    "api_version": "2026-11-19"
34  }
35}

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.