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

GET /v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

curl

curl -i -X GET https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"

response

HTTP/1.1 200 OK
Content-Type: application/vnd.api+json

{
  "data": {
    "id": "03813615-da15-4e3b-8e0a-3ea64b2585de",
    "type": "voice_out_trunks",
    "attributes": {
      "name": "Outbound trunk Name",
      "allowed_rtp_ips": [
        "0.0.0.0/0"
      ],
      "authentication_method": {
        "type": "credentials_and_ip",
        "attributes": {
          "allowed_sip_ips": [
            "0.0.0.0/0"
          ],
          "tech_prefix": "string",
          "username": "554******",
          "password": "fqe******"
        }
      },
      "allow_any_did_as_cli": true,
      "status": "active",
      "on_cli_mismatch_action": "send_original_cli",
      "capacity_limit": 100,
      "threshold_reached": false,
      "threshold_amount": "10000.0",
      "media_encryption_mode": "disabled",
      "default_dst_action": "allow_all",
      "dst_prefixes": [],
      "emergency_enable_all": false,
      "force_symmetric_rtp": false,
      "rtp_ping": false,
      "rtp_timeout": 30,
      "callback_url": null,
      "created_at": "2025-04-02T10:00:00.000Z",
      "external_reference_id": null
    },
    "relationships": {
      "dids": {
        "links": {
          "self": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/relationships/dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/dids"
        }
      },
      "emergency_dids": {
        "links": {
          "self": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/relationships/emergency_dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/03813615-da15-4e3b-8e0a-3ea64b2585de/emergency_dids"
        }
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized