Trunks

Manage your trunks.

List providers

get

Retrieve a collection of providers

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filterstringOptional

Use the filter query parameter to retrieve just a subset of a collection.

searchstringOptional

Use the search query parameter to restrict the results of a request to match a search criterion.

orderbystringOptional

Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.

skipinteger · int32Optional

Use the skip query parameter to set the number of items to skip at the start of a collection.

Default: 0

topinteger · int32 · min: 1 · max: 100Optional

Use the top query parameter to specify the page size of the result set.

Default: 100

Responses

200

OK

application/json

countinteger · int64Optional

Total number of resource.

Example: 100

4XX

Error

get/providers

GET /api/providers HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 1,
  "items": [
    {
      "id": "xxxxxx",
      "name": "example",
      "enabled": true,
      "brand": "Generic",
      "auth_mode": "REGISTER_AUTH",
      "transport": "UDP",
      "hostname": "example",
      "port": 1000,
      "auth_id": "xxxxxx",
      "username": "example",
      "registration": false,
      "register_interval": 600,
      "outbound_server": "",
      "outbound_server_port": 1000,
      "inlan": false,
      "single_via_header": true,
      "rewrite_via_ip": false,
      "verify_port": true,
      "keep_alive": true,
      "keep_alive_interval": 360,
      "concurrency": 100,
      "additional_ips": "",
      "adjust_sdp_direction": false,
      "remove_srtp_info": true,
      "remove_plus_prefix": false,
      "stir_shaken_signature_required": false,
      "tel_uri_scheme_for_request_line": false,
      "tel_uri_scheme_for_to_header": false,
      "did_numbers": "1000-2000",
      "inbound_parameters": {
        "caller_num": "DEFAULT",
        "caller_display_name": "DEFAULT",
        "called_num": "DEFAULT",
        "privacy_types_supported": "DEFAULT",
        "enable_stir_shaken_validation": false,
        "pai_header_parameter_name": "verstat",
        "drop_calls_with_verification_status": [],
        "pass_api_header_to_uad": false
      },
      "outbound_parameters": {
        "request_line_uri_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "request_line_uri_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "contact_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "contact_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "to_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "to_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "to_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "from_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "from_user_part": {
          "value": "OUTBOUND_CALLER_ID",
          "custom_value": ""
        },
        "from_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "remote_party_id_called_party_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "remote_party_id_called_party_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "remote_party_id_called_party_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "remote_party_id_calling_party_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "remote_party_id_calling_party_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "remote_party_id_calling_party_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_asserted_identity_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_asserted_identity_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_asserted_identity_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_preferred_identify_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_preferred_identify_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_preferred_identify_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_called_party_id_display_name": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_called_party_id_user_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "p_called_party_id_host_part": {
          "value": "DEFAULT",
          "custom_value": ""
        },
        "privacy_types_supported": "DEFAULT"
      },
      "shared": false,
      "custom_headers": {
        "add": [
          {
            "name": "example",
            "value": "xxxxxx"
          }
        ],
        "relay": [
          {
            "name": "example"
          }
        ]
      }
    }
  ]
}

Create a provider

post

Add a new provider into system.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestring · min: 1 · max: 64Required

The name of the trunk.

enabledbooleanOptional

Whether to enable the provider.

Default: true

brandstring · min: 1 · max: 64Optional

The brand of trunk.

auth_modestring · enumOptional

Authentication mode:
Can be either:

• IP_AUTH:
• REGISTER_AUTH:
• ACCEPT_REGISTER:
• TEAMS:
• WHATS_APP:

Possible values:

transportstring · enumRequired

The trunk transport protocol:
Can be either:

• UDP:
• TCP:
• TLS:

Possible values:

hostnamestringRequired

Server hostname or IP address

portinteger · int32 · max: 65535Required

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

auth_idstring · max: 64Optional

Authentication ID, i.e. SIP username.

usernamestring · max: 64Optional

Authentication username.

passwordstringOptional

Password for authentication.

registrationbooleanOptional

Whether registration is required.

Default: true

register_intervalinteger · int32Optional

Interval for registry refreshment, in seconds.

Default: 600

outbound_serverstringRequired

The outbound server hostname of the trunk.

outbound_server_portinteger · int32 · max: 65535Required

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

inlanbooleanOptional

Whether the trunk under LAN or not.

Default: false

single_via_headerbooleanOptional

Whether this trunk is only accept single Via SIP header or not.

Default: true

rewrite_via_ipbooleanOptional

Rewrite the host IP of Via header by public IP when sending the request to trunk.

Default: true

verify_portbooleanOptional

Verify the port when receiving SIP messages from trunk

Default: true

keep_alivebooleanOptional

Send OPTIONS message for keep alive.

Default: true

concurrencyinteger · int32Required

The max number of concurrent calls.

keep_alive_intervalinteger · int32Optional

Keep alive message sending interval (seconds).

Default: 360

additional_ipsstringOptional

The additional IP addresses of provider.
A semicolon-separated list of IP addresses in CIDR format.
For example: 192.0.2.0/24;192.0.2.0/32 as defined in RFC 4632 and RFC 4291.

adjust_sdp_directionbooleanOptional

Adjust the SDP direction for call hold.

Default: false

remove_srtp_infobooleanOptional

Remove crypto line in the SDP.

Default: true

remove_plus_prefixbooleanOptional

Remove the "+" prefix from the called number on outbound calls.

Default: true

stir_shaken_signature_requiredbooleanOptional

Whether to enable STIR/SHAKEN signature.

Default: false

tel_uri_scheme_for_request_linebooleanOptional

Whether to Use the Tel URI scheme for the Request Line.

Default: false

tel_uri_scheme_for_to_headerbooleanOptional

Whether to Use the Tel URI scheme for the To header.

Default: false

did_numbersstringOptional

The semicolon-separated list of DID/DDI pool number range or DID/DDI number. Assign a DID/DDI pool number range or DID/DDI number to the tenant. For example: 3000;12000-18000. The DID/DDI pool number range should not overlap with other tenant DID/DDI pool number ranges and numbers.

force_outbound_proxybooleanOptional

Whether to force outbound traffic to be routed through the outbound proxy.

Example: true

Responses

201

Created

application/json

idstringOptionalExample: NzAwNTUxOTA5NzczMTQ4MTYw

4XX

Error

post/providers

POST /api/providers HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2813

{
  "name": "example",
  "enabled": true,
  "brand": "Generic",
  "auth_mode": "REGISTER_AUTH",
  "transport": "UDP",
  "hostname": "example",
  "port": 1000,
  "auth_id": "xxxxxx",
  "username": "user",
  "password": "xxxxxx",
  "registration": false,
  "register_interval": 600,
  "outbound_server": "",
  "outbound_server_port": 1000,
  "inlan": false,
  "single_via_header": true,
  "rewrite_via_ip": false,
  "verify_port": true,
  "keep_alive": true,
  "concurrency": 100,
  "keep_alive_interval": 360,
  "additional_ips": "",
  "adjust_sdp_direction": false,
  "remove_srtp_info": true,
  "remove_plus_prefix": false,
  "stir_shaken_signature_required": false,
  "tel_uri_scheme_for_request_line": false,
  "tel_uri_scheme_for_to_header": false,
  "did_numbers": "1000-2000",
  "inbound_parameters": {
    "caller_num": "DEFAULT",
    "caller_display_name": "DEFAULT",
    "called_num": "DEFAULT",
    "privacy_types_supported": "DEFAULT",
    "enable_stir_shaken_validation": false,
    "pai_header_parameter_name": "verstat",
    "drop_calls_with_verification_status": [],
    "pass_api_header_to_uad": false
  },
  "outbound_parameters": {
    "request_line_uri_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "request_line_uri_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "contact_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "contact_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "from_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "from_user_part": {
      "value": "OUTBOUND_CALLER_ID",
      "custom_value": ""
    },
    "from_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "privacy_types_supported": "DEFAULT"
  },
  "custom_headers": {
    "add": [
      {
        "name": "example",
        "value": "xxxxxx"
      }
    ],
    "relay": [
      {
        "name": "example"
      }
    ]
  }
}

{
  "id": "xxxxxxxx"
}

Retrieve a provider

get

Get details of a provider by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

OK

application/json

idstringOptionalExample: NzAwNTUxOTA5NzczMTQ4MTYw

namestring · min: 1 · max: 64Optional

The name of the trunk.

enabledbooleanOptional

Whether to enable the provider.

Default: true

brandstring · min: 1 · max: 64Optional

The brand of trunk.

auth_modestring · enumOptional

Authentication mode:
Can be either:

• IP_AUTH:
• REGISTER_AUTH:
• ACCEPT_REGISTER:
• TEAMS:
• WHATS_APP:

Possible values:

transportstring · enumOptional

The trunk transport protocol:
Can be either:

• UDP:
• TCP:
• TLS:

Possible values:

hostnamestringOptional

Server hostname or IP address

portinteger · int32 · max: 65535Optional

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

auth_idstring · max: 64Optional

Authentication ID, i.e. SIP username.

usernamestring · max: 64Optional

Authentication username.

registrationbooleanOptional

Whether registration is required.

Default: true

register_intervalinteger · int32Optional

Interval for registry refreshment, in seconds.

Default: 600

outbound_serverstringOptional

The outbound server hostname of the trunk.

outbound_server_portinteger · int32 · max: 65535Optional

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

inlanbooleanOptional

Whether the trunk under LAN or not.

Default: false

single_via_headerbooleanOptional

Whether this trunk is only accept single Via SIP header or not.

Default: true

rewrite_via_ipbooleanOptional

Rewrite the host IP of Via header by public IP when sending the request to trunk.

Default: true

verify_portbooleanOptional

Verify the port when receiving SIP messages from trunk

Default: true

keep_alivebooleanOptional

Send OPTIONS message for keep alive.

Default: true

keep_alive_intervalinteger · int32Optional

Keep alive message sending interval (seconds).

Default: 360

concurrencyinteger · int32Optional

The max number of concurrent calls.

additional_ipsstringOptional

The additional IP addresses of provider.
A semicolon-separated list of IP addresses in CIDR format.
For example: 192.0.2.0/24;192.0.2.0/32 as defined in RFC 4632 and RFC 4291.

adjust_sdp_directionbooleanOptional

Adjust the SDP direction for call hold.

Default: false

remove_srtp_infobooleanOptional

Remove crypto line in the SDP.

Default: true

remove_plus_prefixbooleanOptional

Remove the "+" prefix from the called number on outbound calls.

Default: true

stir_shaken_signature_requiredbooleanOptional

Whether to enable STIR/SHAKEN signature.

Default: false

tel_uri_scheme_for_request_linebooleanOptional

Whether to Use the Tel URI scheme for the Request Line.

Default: false

tel_uri_scheme_for_to_headerbooleanOptional

Whether to Use the Tel URI scheme for the To header.

Default: false

did_numbersstringOptional

The semicolon-separated list of DID/DDI pool number range or DID/DDI number. Assign a DID/DDI pool number range or DID/DDI number to the tenant. For example: 3000;12000-18000. The DID/DDI pool number range should not overlap with other tenant DID/DDI pool number ranges and numbers.

sharedbooleanOptional

The flag of whether the trunk is shared.

force_outbound_proxybooleanOptional

Whether to force outbound traffic to be routed through the outbound proxy.

Example: true

4XX

Error

get/providers/{id}

GET /api/providers/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "xxxxxx",
  "name": "example",
  "enabled": true,
  "brand": "Generic",
  "auth_mode": "REGISTER_AUTH",
  "transport": "UDP",
  "hostname": "example",
  "port": 1000,
  "auth_id": "xxxxxx",
  "username": "user",
  "registration": false,
  "register_interval": 600,
  "outbound_server": "",
  "outbound_server_port": 1000,
  "inlan": false,
  "single_via_header": true,
  "rewrite_via_ip": false,
  "verify_port": true,
  "keep_alive": true,
  "keep_alive_interval": 360,
  "concurrency": 100,
  "additional_ips": "",
  "adjust_sdp_direction": false,
  "remove_srtp_info": true,
  "remove_plus_prefix": false,
  "stir_shaken_signature_required": false,
  "tel_uri_scheme_for_request_line": false,
  "tel_uri_scheme_for_to_header": false,
  "did_numbers": "1000-2000",
  "inbound_parameters": {
    "caller_num": "DEFAULT",
    "caller_display_name": "DEFAULT",
    "called_num": "DEFAULT",
    "privacy_types_supported": "DEFAULT",
    "enable_stir_shaken_validation": false,
    "pai_header_parameter_name": "verstat",
    "drop_calls_with_verification_status": [],
    "pass_api_header_to_uad": false
  },
  "outbound_parameters": {
    "request_line_uri_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "request_line_uri_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "contact_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "contact_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "from_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "from_user_part": {
      "value": "OUTBOUND_CALLER_ID",
      "custom_value": ""
    },
    "from_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "privacy_types_supported": "DEFAULT"
  },
  "shared": false,
  "custom_headers": {
    "add": [
      {
        "name": "example",
        "value": "xxxxxx"
      }
    ],
    "relay": [
      {
        "name": "example"
      }
    ]
  }
}

Update provider

post

Update properties of provider by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Body

namestring · min: 1 · max: 64Optional

The name of the trunk.

enabledbooleanOptional

Whether to enable the provider.

Default: true

transportstring · enumOptional

The trunk transport protocol:
Can be either:

• UDP:
• TCP:
• TLS:

Possible values:

hostnamestringOptional

Server hostname or IP address

portinteger · int32 · max: 65535Optional

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

auth_idstring · max: 64Optional

Authentication ID, i.e. SIP username.

usernamestring · max: 64Optional

Authentication username.

passwordstringOptional

Password for authentication.

registrationbooleanOptional

Whether registration is required.

Default: true

register_intervalinteger · int32Optional

Interval for registry refreshment, in seconds.

Default: 600

outbound_serverstringOptional

The outbound server hostname of the trunk.

outbound_server_portinteger · int32 · max: 65535Optional

A port number is a 16-bit unsigned integer, thus ranging from 0 to 65535. For TCP, port number 0 is reserved and cannot be used, while for UDP, the source port is optional and a value of zero means no port

Example: 80

inlanbooleanOptional

Whether the trunk under LAN or not.

Default: false

single_via_headerbooleanOptional

Whether this trunk is only accept single Via SIP header or not.

Default: true

rewrite_via_ipbooleanOptional

Rewrite the host IP of Via header by public IP when sending the request to trunk.

Default: true

verify_portbooleanOptional

Verify the port when receiving SIP messages from trunk

Default: true

keep_alivebooleanOptional

Send OPTIONS message for keep alive.

Default: true

keep_alive_intervalinteger · int32Optional

Keep alive message sending interval (seconds).

Default: 360

concurrencyinteger · int32Optional

The max number of concurrent calls.

additional_ipsstringOptional

The additional IP addresses of provider.
A semicolon-separated list of IP addresses in CIDR format.
For example: 192.0.2.0/24;192.0.2.0/32 as defined in RFC 4632 and RFC 4291.

adjust_sdp_directionbooleanOptional

Adjust the SDP direction for call hold.

Default: false

remove_srtp_infobooleanOptional

Remove crypto line in the SDP.

Default: true

remove_plus_prefixbooleanOptional

Remove the "+" prefix from the called number on outbound calls.

Default: true

stir_shaken_signature_requiredbooleanOptional

Whether to enable STIR/SHAKEN signature.

Default: false

tel_uri_scheme_for_request_linebooleanOptional

Whether to Use the Tel URI scheme for the Request Line.

Default: false

tel_uri_scheme_for_to_headerbooleanOptional

Whether to Use the Tel URI scheme for the To header.

Default: false

did_numbersstringOptional

The semicolon-separated list of DID/DDI pool number range or DID/DDI number. Assign a DID/DDI pool number range or DID/DDI number to the tenant. For example: 3000;12000-18000. The DID/DDI pool number range should not overlap with other tenant DID/DDI pool number ranges and numbers.

force_outbound_proxybooleanOptional

Whether to force outbound traffic to be routed through the outbound proxy.

Example: true

Responses

200

OK

No content

4XX

Error

post/providers/{id}

POST /api/providers/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2767

{
  "name": "example",
  "enabled": true,
  "transport": "UDP",
  "hostname": "example",
  "port": 1000,
  "auth_id": "xxxxxx",
  "username": "user",
  "password": "xxxxxx",
  "registration": false,
  "register_interval": 600,
  "outbound_server": "",
  "outbound_server_port": 1000,
  "inlan": false,
  "single_via_header": true,
  "rewrite_via_ip": false,
  "verify_port": true,
  "keep_alive": true,
  "keep_alive_interval": 360,
  "concurrency": 100,
  "additional_ips": "",
  "adjust_sdp_direction": false,
  "remove_srtp_info": true,
  "remove_plus_prefix": false,
  "stir_shaken_signature_required": false,
  "tel_uri_scheme_for_request_line": false,
  "tel_uri_scheme_for_to_header": false,
  "did_numbers": "1000-2000",
  "inbound_parameters": {
    "caller_num": "DEFAULT",
    "caller_display_name": "DEFAULT",
    "called_num": "DEFAULT",
    "privacy_types_supported": "DEFAULT",
    "enable_stir_shaken_validation": false,
    "pai_header_parameter_name": "verstat",
    "drop_calls_with_verification_status": [],
    "pass_api_header_to_uad": false
  },
  "outbound_parameters": {
    "request_line_uri_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "request_line_uri_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "contact_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "contact_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "to_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "from_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "from_user_part": {
      "value": "OUTBOUND_CALLER_ID",
      "custom_value": ""
    },
    "from_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_called_party_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "remote_party_id_calling_party_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_asserted_identity_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_preferred_identify_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_display_name": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_user_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "p_called_party_id_host_part": {
      "value": "DEFAULT",
      "custom_value": ""
    },
    "privacy_types_supported": "DEFAULT"
  },
  "custom_headers": {
    "add": [
      {
        "name": "example",
        "value": "xxxxxx"
      }
    ],
    "relay": [
      {
        "name": "example"
      }
    ]
  }
}

No content

Query provider status

get

Get status of provider by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

200

Success

application/json

statusstring · enumRead-onlyOptional

Trunk status includes:

• ONLINE:
• OFFLINE:

Possible values:

4XX

Error

get/providers/{id}/status

GET /api/providers/{id}/status HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "ONLINE"
}

Delete a provider

post

Destroy provider by it's unique ID.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequiredExample: NzAwNTUxOTA5NzczMTQ4MTYw

Responses

204

No Content

No content

400

Invalid provider ID supplied.

409

Provider is still referenced by an inbound or outbound rule (RESOURCE_IN_USE).

post/providers/{id}/destroy

POST /api/providers/{id}/destroy HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Export providers

get

Export a collection of providers to file.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/octet-stream

Responsestring · binary

4XX

Error

get/providers/export

GET /api/providers/export HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary