---
title: Get a list of shared permissions
description: GET /nd/api/share/share_roles: Get the shared permission list interface description, including path, method, parameters and return information.
slug: api-get-nd-api-share-share-roles
lang: en
category: Sharing API
category_order: 8
order: 127
api_method: GET
api_path: /nd/api/share/share_roles
api_label: Get a list of shared permissions
keywords:
  - API
  - Get a list of shared permissions
  - /nd/api/share/share_roles
---

# Get the shared permission list

| Properties | Values |
| --- | --- |
| HTTP methods | `GET` |
| Interface path | `/nd/api/share/share_roles` |
| Category | Share API |

## Interface description

Interface path: `/nd/api/share/share_roles`

HTTP method: `GET`


**HTTP method:** `GET`

#### URL parameters

Parameter name Comment (description)
#### Return field description

{"code":0,"roles":[],"success":true}

## Call instructions

- Before calling, you need to complete [Get token](api-post-api-token-do.md) or the corresponding login-free authentication, and carry `Authorization: Bearer <access_token>` in the request header.
- If there are differences in parameters and return fields due to deployment versions, the actual private cloud API documents and joint debugging results should prevail.
- Category: Sharing API.