# Get Inbound Trunk Group

Returns a single inbound trunk group.

## Request

HTTP Method: `GET`

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

Note

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

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique ID identifier of the Trunk Group. |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes). |

### Includes

| Value | Description |
| --- | --- |
| voice\_in\_trunks | [List of Trunk Objects](../voice-in-trunks/voice-in-trunk-object.html#voice-in-trunk-object-v35) |

## Examples

Simple RequestIncluded Trunks

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/voice_in_trunk_groups/418fe352-04b8-4e03-a7ce-cb57efd8c664 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_trunk_groups/418fe352-04b8-4e03-a7ce-cb57efd8c664 -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": "418fe352-04b8-4e03-a7ce-cb57efd8c664",
 7    "type": "voice_in_trunk_groups",
 8    "attributes": {
 9      "created_at": "2017-06-25T14:56:31.513Z",
10      "external_reference_id": null,
11      "name": "Common Group",
12      "capacity_limit": 69
13    },
14    "relationships": {
15      "voice_in_trunks": {
16        "links": {
17          "self": "https://api.didww.com/v3/voice_in_trunk_groups/418fe352-04b8-4e03-a7ce-cb57efd8c664/relationships/voice_in_trunks",
18          "related": "https://api.didww.com/v3/voice_in_trunk_groups/418fe352-04b8-4e03-a7ce-cb57efd8c664/voice_in_trunks"
19        }
20      }
21    },
22    "meta": {
23      "trunks_count": 1
24    }
25  },
26  "meta": {
27    "api_version": "2026-11-19"
28  }
29}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/voice_in_trunk_groups/465b059a-b4a2-4c8e-ab3b-33dc60e096ae?include=voice_in_trunks 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_trunk_groups/465b059a-b4a2-4c8e-ab3b-33dc60e096ae?include=voice_in_trunks' -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": "465b059a-b4a2-4c8e-ab3b-33dc60e096ae",
 7    "type": "voice_in_trunk_groups",
 8    "attributes": {
 9      "created_at": "2017-06-25T14:56:31.513Z",
10      "external_reference_id": null,
11      "name": "Common Group",
12      "capacity_limit": 69
13    },
14    "relationships": {
15      "voice_in_trunks": {
16        "links": {
17          "self": "https://api.didww.com/v3/voice_in_trunk_groups/465b059a-b4a2-4c8e-ab3b-33dc60e096ae/relationships/voice_in_trunks",
18          "related": "https://api.didww.com/v3/voice_in_trunk_groups/465b059a-b4a2-4c8e-ab3b-33dc60e096ae/voice_in_trunks"
19        },
20        "data": [
21          {
22            "type": "voice_in_trunks",
23            "id": "87133f4d-4a88-436b-b74b-b63e79318426"
24          }
25        ]
26      }
27    },
28    "meta": {
29      "trunks_count": 1
30    }
31  },
32  "included": [
33    {
34      "id": "87133f4d-4a88-436b-b74b-b63e79318426",
35      "type": "voice_in_trunks",
36      "attributes": {
37        "priority": 1,
38        "capacity_limit": 5,
39        "weight": 65535,
40        "name": "Office Mobile",
41        "cli_format": "e164",
42        "cli_prefix": null,
43        "description": null,
44        "ringing_timeout": null,
45        "pop": null,
46        "created_at": "2017-06-25T08:21:41.795Z",
47        "external_reference_id": null,
48        "configuration": {
49          "type": "pstn_configurations",
50          "attributes": {
51            "dst": "1xxxxxxxxx"
52          }
53        }
54      },
55      "relationships": {
56        "voice_in_trunk_group": {
57          "links": {
58            "self": "https://api.didww.com/v3/voice_in_trunks/87133f4d-4a88-436b-b74b-b63e79318426/relationships/voice_in_trunk_group",
59            "related": "https://api.didww.com/v3/voice_in_trunks/87133f4d-4a88-436b-b74b-b63e79318426/voice_in_trunk_group"
60          }
61        }
62      }
63    }
64  ],
65  "meta": {
66    "api_version": "2026-11-19"
67  }
68}
```

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