---
title: "Read Permissions in a DialPolicy in Domain"
method: GET
path: "/domains/{domain}/dialpolicy/{policy}/permission"
tags: ["Dial Permisions"]
---

# Read Permissions in a DialPolicy in Domain

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

## Request

- Base URL: `https://ns-api.com/ns-api/v2`
- URL: `https://ns-api.com/ns-api/v2/domains/{domain}/dialpolicy/{policy}/permission`
- Auth: HTTP bearer

## Path parameters

- `domain` string, required: This is the main organization name. This is used to link resource to its group/tenant/organization/enterprise. Then using in path for GET you can set to "~" to use the domain name linked to your token/key instead of the domain name itself when reading for your own domain.
- `policy` string, required

## Response `200`

- Permission[]
  - `dialpolicy` string, required: The Dial Policy Name
  - `domain` string: The domain the owns the Dial Policy
  - `permission-match` string, required: The specific match to check against
  - `permission-mode` 'permit' | 'deny', required: To allow or deny specific match
  - `permission-reason` string, required: The description/reason for making the rule.
  - `created-datetime` string: The time the rule was created
  - `permission-id` string, required: This is the ID fro the permission rule. Its the base64 encode of permission-match, but is needed for edit and delete.

## Other responses

- `400`
- `401`
- `404`

## Changes

- **2026-11-03** `bce16087d479`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/changes/domains/:domain/dialpolicy/:policy/permission/get.md)

---

[API](https://skmtc.dev/ns-api/apis/netsapiens-api-v2.md) - [All operations](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/revisions/bce16087d479?raw)