Get Outbound Trunk#

Returns a single outbound trunk owned by the account.

Request#

HTTP Method: GET

URI Path: /v3/voice_out_trunks/{id}

Note

For all returned data attributes, see Outbound Trunk Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique identifier of the outbound trunk.

include

string

No

Inclusion.

Includes#

Value

Description

dids

DID Object

emergency_dids

Emergency DID relationship data.

Object Relationships#

Value

Description

dids

DID Object

emergency_dids

Emergency DID relationship data.

Examples#

http

1GET /v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de 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_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de -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": "03813615-da15-4e3b-8e0a-3ea64b2585de",
 7    "type": "voice_out_trunks",
 8    "attributes": {
 9      "name": "Outbound trunk Name",
10      "allowed_rtp_ips": [
11        "203.0.113.0/24"
12      ],
13      "authentication_method": {
14        "type": "credentials_and_ip",
15        "attributes": {
16          "allowed_sip_ips": [
17            "0.0.0.0/0"
18          ],
19          "tech_prefix": null,
20          "username": "554******",
21          "password": "fqe******"
22        }
23      },
24      "allow_any_did_as_cli": true,
25      "status": "active",
26      "on_cli_mismatch_action": "send_original_cli",
27      "capacity_limit": 100,
28      "threshold_reached": false,
29      "threshold_amount": "10000.0",
30      "media_encryption_mode": "disabled",
31      "ice_mode": "accept",
32      "rtcp_mux_mode": "accept",
33      "rtcp_feedback_mode": "accept",
34      "codecs": [
35        "pcma",
36        "pcmu",
37        "g729",
38        "g723",
39        "gsm",
40        "telephone_event"
41      ],
42      "default_dst_action": "allow_all",
43      "dst_prefixes": [],
44      "emergency_enable_all": false,
45      "force_symmetric_rtp": false,
46      "rtp_ping": false,
47      "rtp_timeout": 30,
48      "callback_url": null,
49      "created_at": "2025-04-02T10:00:00.000Z",
50      "external_reference_id": null
51    },
52    "relationships": {
53      "dids": {
54        "links": {
55          "self": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/relationships/dids",
56          "related": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/dids"
57        }
58      },
59      "emergency_dids": {
60        "links": {
61          "self": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/relationships/emergency_dids",
62          "related": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/emergency_dids"
63        }
64      }
65    },
66    "meta": {
67      "spent_amount": "12.34"
68    }
69  },
70  "meta": {
71    "api_version": "2026-11-19"
72  }
73}

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized

403

No

The Outbound API is not enabled for the account.

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.