**Source URL:** https://general.veevavault.dev/clinical/vault-api/api-reference/26.1/document-binder-roles/document-roles/retrieve-document-role.md

# Retrieve Document Role



Retrieve a specific role on a document and the users and groups assigned to it.

<Endpoint path="/api/{version}/objects/documents/{doc_id}/roles/{role_name}" method="GET"></Endpoint>

## Headers {#headers}

| Name | Description |
| --- | --- |
| `Accept` | `application/json` (default) or `application/xml` |

## URI Path Parameters {#uri-path-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `{doc_id}` | The document `id` field value. |
| `{role_name}` | The name of the role to retrieve. For example, `owner__v`. |
</FieldTable>

## Request {#request}

<CodeExample title="">
```
curl -X GET -H "Authorization: {SESSION_ID}" \
https://myvault.veevavault.com/api/v25.1/objects/documents/245/roles/reviewer__v

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "responseMessage": "Document role retrieved",
    "errorCodes": null,
    "documentRoles": [
        {
            "name": "reviewer__v",
            "label": "Reviewer",
            "assignedUsers": [
                25496,
                26231
            ],
            "assignedGroups": [
                1,
                2
            ],
            "availableUsers": [
                25496,
                26231,
                28874
            ],
            "availableGroups": [
                1,
                2,
                3
            ],
            "defaultUsers": [
                25496,
                26231
            ],
            "defaultGroups": [
                1,
                2
            ]
        }
    ],
    "errorType": null
}

```
</CodeExample>

## Response Details {#response-details}

On `SUCCESS`, the response lists the following for the specific role retrieved:

| Name | Description |
| --- | --- |
| `name` | The role name available to developers. For example, `reviewer__v`. |
| `label` | The UI-friendly role label available to Admins in the Vault UI. For example, `Reviewer`. |
| `assignedUsers` | List of the IDs of users assigned to this role |
| `assignedGroups` | List of the IDs of groups assigned to this role |
| `availableUsers` | List of the IDs of users available for this role |
| `availableGroups` | List of the IDs of groups available to this role |
| `defaultUsers` | List of the IDs of default users assigned to this role |
| `defaultGroups` | List of the IDs of default groups assigned to this role |


---

**Previous:** [Retrieve All Document Roles](/clinical/vault-api/api-reference/26.1/document-binder-roles/document-roles/retrieve-all-document-roles)  
**Next:** [Assign Users & Groups to Roles on a Single Document](/clinical/vault-api/api-reference/26.1/document-binder-roles/document-roles/assign-users-groups-to-roles-on-a-single-document)