---
title: "PermissionType and Access List"
method: GET
path: "/v2/ref/permissions"
tags: ["Reference Resources"]
---

# PermissionType and Access List

`GET /v2/ref/permissions`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/ref/permissions`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/ref/permissions/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of available Permission Types and their max Access level for a given UserType

## Query parameters

- `usertype` 'AccountUser' | 'EndUser' | 'ManagementUser' | 'AlianzaUser' | 'BusinessLines'

## Response `200`

Successful operation

- PermissionTypeDefaultsX[]
  - `type` 'NONE' | 'Account' | 'AccountHistory' | 'AccountCallHistory' | 'AccountBulkStatuses' | 'IpWhitelist' | 'PhoneNumber' | 'PhoneNumberServiceActivation' | 'PhoneNumberInventory' | 'Product' | 'ProductCallingPlan' | 'ProductGroups' | 'ProductUsers' | 'Reports' | 'RoutePlan' | 'SipCredentials' | 'EU_DeviceSwapCreate' | 'EU_Account' | 'EU_AccountMedia' | 'EU_CallHistory' | 'EU_Device' | 'EU_DeviceSwap' | 'EU_DeviceLine' | 'EU_IVR' | 'EU_LineAppearance' | 'EU_LineHardware' | 'EU_LineHuntGroup' | 'EU_Voicemail' | 'EU_VoicemailMessage' | 'EU_VoicemailUnlock' | 'EU_Telephone' | 'EU_SipTrunk' | 'EU_User' | 'EU_UserResetPassword' | 'EU_History' | 'EU_BUSINESS_LINE' | 'EU_BUSINESS_LINE_PROVISIONING' | 'EU_BUSINESS_LINE_VOICEMAIL' | 'EU_BUSINESS_LINE_HUNT_GROUP' | 'EU_911_ADDRESS' | 'EU_TELEPHONE_DESTINATION' | 'EU_ENDUSER_REPURPOSE' | 'ALIANZA_MasterRoutePlan' | 'ALIANZA_TogglzAdmin' | 'ANY_END_USER' | 'ANY_MANAGEMENT_USER' | 'ANY_ALIANZA_USER'
  - `maxAccessType` 'NONE' | 'READ_MYUSER' | 'READ' | 'EDIT_MYUSER' | 'EDIT' | 'CREATE_MYUSER' | 'CREATE' | 'DELETE_MYUSER' | 'DELETE' | 'DENIED'

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/7223246c352c?raw)