Get Voice IN Trunks#

Description

Returns the collection of Tunks.

Request#

HTTP Method: GET

URI Path: /v3/voice_in_trunks

URI Query Parameters:

Name

Type

Is Required?

Description

filter[<filter_name>]

string

Optional

Filtering

sort

string

Optional

Sorting

Filters:

Filter Name

Type

Allow Blank

Allow Array

Filters by:

id

string

No

Yes

Trunk id field.

name

string

Yes

Yes

Trunk name field.

configuration.type

string

Yes

Yes

The type of configuration (SIP, PSTN, etc).

Sorting:

Value

Sorts by:

name

The name field.

priority

The priority field.

capacity_limit

The capacity_limit field.

weight

The weight field.

cli_format

The cli_format field.

cli_prefix

The cli_prefix field.

description

The description field.

ringing_timeout

The ringing_timeout field.

created_at

The created_at field.

Sparse Fieldsets:

Value

Returns:

name

The name attribute.

priority

The priority attribute.

capacity_limit

The capacity_limit attribute.

weight

The weight attribute.

cli_format

The cli_format attribute.

cli_prefix

The cli_prefix attribute.

description

The description attribute.

ringing_timeout

The ringing_timeout attribute.

created_at

The created_at attribute.

Example#

http

1GET /v3/voice_in_trunks HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Api-Key: [API token]

curl

1curl -i -X GET https://api.didww.com/v3/voice_in_trunks -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json"

response

  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4{
  5  "data": [
  6    {
  7      "id": "2d7f943f-07c4-4b27-8792-e85806368218",
  8      "type": "voice_in_trunks",
  9      "attributes": {
 10        "priority": 1,
 11        "capacity_limit": 10,
 12        "weight": 2,
 13        "name": "Office",
 14        "cli_format": "e164",
 15        "cli_prefix": "+",
 16        "description": null,
 17        "ringing_timeout": 30,
 18        "created_at": "2017-06-25T08:21:41.795Z",
 19        "configuration": {
 20          "type": "sip_configurations",
 21          "attributes": {
 22            "username": "username",
 23            "host": "example.com",
 24            "port": null,
 25            "codec_ids": [
 26              9,
 27              7
 28            ],
 29            "rx_dtmf_format_id": 1,
 30            "tx_dtmf_format_id": 1,
 31            "resolve_ruri": true,
 32            "auth_enabled": true,
 33            "auth_user": "username",
 34            "auth_password": "password",
 35            "auth_from_user": "Office",
 36            "auth_from_domain": "example.com",
 37            "sst_enabled": false,
 38            "sst_min_timer": 600,
 39            "sst_max_timer": 900,
 40            "sst_accept_501": true,
 41            "sip_timer_b": 8000,
 42            "dns_srv_failover_timer": 2000,
 43            "rtp_ping": false,
 44            "rtp_timeout": 30,
 45            "force_symmetric_rtp": false,
 46            "symmetric_rtp_ignore_rtcp": false,
 47            "rerouting_disconnect_code_ids": [
 48              58,
 49              59,
 50              1505
 51            ],
 52            "sst_session_expires": null,
 53            "sst_refresh_method_id": 1,
 54            "transport_protocol_id": 1,
 55            "max_transfers": 5,
 56            "max_30x_redirects": 7,
 57            "media_encryption_mode": "disabled",
 58            "stir_shaken_mode": "disabled",
 59            "allowed_rtp_ips": null
 60          }
 61        }
 62      },
 63      "relationships": {
 64        "voice_in_trunk_group": {
 65          "links": {
 66            "self": "https://api.didww.com/v3/voice_in_trunks/2d7f943f-07c4-4b27-8792-e85806368218/relationships/voice_in_trunk_group",
 67            "related": "https://api.didww.com/v3/voice_in_trunks/2d7f943f-07c4-4b27-8792-e85806368218/voice_in_trunk_group"
 68          }
 69        }
 70      }
 71    },
 72    {
 73      "id": "34b95e8c-9b78-4e64-aea8-9e5764d8f16f",
 74      "type": "voice_in_trunks",
 75      "attributes": {
 76        "priority": 1,
 77        "capacity_limit": 5,
 78        "weight": 65535,
 79        "name": "Office Mobile",
 80        "cli_format": "e164",
 81        "cli_prefix": null,
 82        "description": null,
 83        "ringing_timeout": null,
 84        "created_at": "2017-06-25T08:21:41.795Z",
 85        "configuration": {
 86          "type": "pstn_configurations",
 87          "attributes": {
 88            "dst": "1xxxxxxxxx"
 89          }
 90        }
 91      },
 92      "relationships": {
 93        "voice_in_trunk_group": {
 94          "links": {
 95            "self": "https://api.didww.com/v3/voice_in_trunks/34b95e8c-9b78-4e64-aea8-9e5764d8f16f/relationships/voice_in_trunk_group",
 96            "related": "https://api.didww.com/v3/voice_in_trunks/34b95e8c-9b78-4e64-aea8-9e5764d8f16f/voice_in_trunk_group"
 97          }
 98        }
 99      }
100    }
101  ],
102  "meta": {
103    "total_records": 2
104  },
105  "links": {
106    "first": "https://api.didww.com/v3/voice_in_trunks?page%5Bnumber%5D=1&page%5Bsize%5D=50",
107    "last": "https://api.didww.com/v3/voice_in_trunks?page%5Bnumber%5D=1&page%5Bsize%5D=50"
108  }
109}