List shared dial policy rules

GET

/dialpolicy/{policy}/permission

Last modified:2026-10-08 23:01:37

OperationId:ReadPermissionsDialpolicy

Lists the rules of a shared dial policy, the one filed under * or admin-only. A rule matches a dialed destination in permission-match and either permits or denies the call (permission-mode).

Requires Super User, Super User Read Only or Reseller scope. Office Manager and Site Manager scopes answer 403: they read rules through /domains/{domain}/dialpolicy/{policy}/permission.

This path never returns rules filed under a domain. An unknown policy returns an empty array. Append /count for the number of rules, or /list for the reduced shape.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The policy's rules, as an array. An empty array means the shared policy has no rules or does not exist.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/dialpolicy//permission?start=undefined&limit=100' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Shared rules

Two rules of the shared US and Canada policy.

[
    {
        "dialpolicy": "US and Canada",
        "domain": "*",
        "permission-match": "*",
        "permission-mode": "permit",
        "permission-reason": "Permit All",
        "created-datetime": "2026-09-01T14:30:00Z",
        "permission-id": "Kg"
    },
    {
        "dialpolicy": "US and Canada",
        "domain": "*",
        "permission-match": "sip:+1242???????@*",
        "permission-mode": "deny",
        "permission-reason": "Bahamas",
        "created-datetime": "2026-09-01T14:30:00Z",
        "permission-id": "c2lwOisxMjQyPz8_Pz8_P0Aq"
    }
]

Modified at 2026-10-08 23:01:37

Read domain dial policy

List domain dial policy rules