# 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](voice-out-trunk-object.html).

### URI Query Parameters

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

### Includes

| Value | Description |
| --- | --- |
| dids | [DID Object](../did/did-object.html#did-object-v34) |
| emergency\_dids | Emergency DID relationship data. |

### Object Relationships

| Value | Description |
| --- | --- |
| dids | [DID Object](../did/did-object.html#did-object-v34) |
| emergency\_dids | Emergency DID relationship data. |

## Examples

credentials\_and\_ipip\_onlytwilioinclude emergency\_dids

[[DIDWW-API-EXAMPLE-START]]

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"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/voice_out_trunks/cf2e6377-fcaa-4416-8c8e-acd5f31a427f 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/cf2e6377-fcaa-4416-8c8e-acd5f31a427f -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": "cf2e6377-fcaa-4416-8c8e-acd5f31a427f",
    "type": "voice_out_trunks",
    "attributes": {
      "name": "Outbound trunk Name",
      "allowed_rtp_ips": [
        "198.51.100.1/32"
      ],
      "authentication_method": {
        "type": "ip_only",
        "attributes": {
          "allowed_sip_ips": [
            "198.51.100.1/32"
          ],
          "tech_prefix": null
        }
      },
      "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": true,
      "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/cf2e6377-fcaa-4416-8c8e-acd5f31a427f/relationships/dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/cf2e6377-fcaa-4416-8c8e-acd5f31a427f/dids"
        }
      },
      "emergency_dids": {
        "links": {
          "self": "https://api.didww.com/v3/voice_out_trunks/cf2e6377-fcaa-4416-8c8e-acd5f31a427f/relationships/emergency_dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/cf2e6377-fcaa-4416-8c8e-acd5f31a427f/emergency_dids"
        }
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/voice_out_trunks/14a0b7fb-845a-44d9-a7dc-ac1620f21e42 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/14a0b7fb-845a-44d9-a7dc-ac1620f21e42 -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": "14a0b7fb-845a-44d9-a7dc-ac1620f21e42",
    "type": "voice_out_trunks",
    "attributes": {
      "name": "Outbound trunk Name",
      "allowed_rtp_ips": null,
      "authentication_method": {
        "type": "twilio",
        "attributes": {
          "twilio_account_sid": "AC39347AF064AF97E1682C3B7332DAAEE6"
        }
      },
      "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/14a0b7fb-845a-44d9-a7dc-ac1620f21e42/relationships/dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/14a0b7fb-845a-44d9-a7dc-ac1620f21e42/dids"
        }
      },
      "emergency_dids": {
        "links": {
          "self": "https://api.didww.com/v3/voice_out_trunks/14a0b7fb-845a-44d9-a7dc-ac1620f21e42/relationships/emergency_dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/14a0b7fb-845a-44d9-a7dc-ac1620f21e42/emergency_dids"
        }
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
GET /v3/voice_out_trunks/91f7bcb4-3278-433b-9de1-5e6f4131fd4d?include=emergency_dids 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/91f7bcb4-3278-433b-9de1-5e6f4131fd4d?include=emergency_dids' -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": "91f7bcb4-3278-433b-9de1-5e6f4131fd4d",
    "type": "voice_out_trunks",
    "attributes": {
      "name": "Outbound trunk with emergency DID",
      "allowed_rtp_ips": [
        "198.51.100.0/24"
      ],
      "authentication_method": {
        "type": "credentials_and_ip",
        "attributes": {
          "allowed_sip_ips": [
            "198.51.100.0/24"
          ],
          "tech_prefix": null,
          "username": "9q2******",
          "password": "6zm******"
        }
      },
      "allow_any_did_as_cli": true,
      "status": "active",
      "on_cli_mismatch_action": "send_original_cli",
      "capacity_limit": 75,
      "threshold_reached": false,
      "threshold_amount": "3000.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/91f7bcb4-3278-433b-9de1-5e6f4131fd4d/relationships/dids",
          "related": "https://api.didww.com/v3/voice_out_trunks/91f7bcb4-3278-433b-9de1-5e6f4131fd4d/dids"
        }
      },
      "emergency_dids": {
        "data": [
          {
            "type": "dids",
            "id": "0b5d4ca6-7002-4f19-a678-f5be95538e9b"
          }
        ]
      }
    }
  },
  "included": [
    {
      "id": "0b5d4ca6-7002-4f19-a678-f5be95538e9b",
      "type": "dids",
      "attributes": {
        "number": "12125550124",
        "emergency_enabled": true
      }
    }
  ],
  "meta": {
    "api_version": "2026-04-16"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page