List domain dial policy rules

GET

/domains/{domain}/dialpolicy/{policy}/permission

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

OperationId:ReadPermissionsDialpolicyDomain

Lists the rules of a dial policy as a domain sees it: rules filed under the domain plus those of the shared policy with this name under * or admin-only. A rule matches a dialed destination in permission-match and either permits or denies the call (permission-mode).

Requires Office Manager scope or higher for the domain. Office Manager, Site Manager, Call Center Supervisor and Route Manager scopes read their own domain only; a Reseller reads domains in its territory.

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 rules, as an array. An empty array means the policy has no rules or does not exist.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Domain rules

Two rules of a domain policy.

[
    {
        "dialpolicy": "No Premium",
        "domain": "example.com",
        "permission-match": "*",
        "permission-mode": "permit",
        "permission-reason": "Permit all",
        "created-datetime": "2026-09-01T14:30:00Z",
        "permission-id": "Kg"
    },
    {
        "dialpolicy": "No Premium",
        "domain": "example.com",
        "permission-match": "sip:+1900???????@*",
        "permission-mode": "deny",
        "permission-reason": "Premium rate",
        "created-datetime": "2026-09-01T14:30:00Z",
        "permission-id": "c2lwOisxOTAwPz8_Pz8_P0Aq"
    }
]

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

List shared dial policy rules

Read shared dial policy rule