---
title: "Returns the authorizations for which the specified user is the principal user."
method: GET
path: "/v2.1/accounts/{accountId}/users/{userId}/authorizations"
tags: ["Authorizations"]
---

# Returns the authorizations for which the specified user is the principal user.

`GET /v2.1/accounts/{accountId}/users/{userId}/authorizations`

## Request

- Base URL: `https://www.docusign.net/restapi`
- URL: `https://www.docusign.net/restapi/v2.1/accounts/{accountId}/users/{userId}/authorizations`
- Auth: none declared

Returns the user authorizations for which the user specified by `userId` is the principal user.

To call this endpoint, you must be an account administrator or you must be the specified principal user.

## Path parameters

- `accountId` string, required
- `userId` string, required

## Query parameters

- `active_only` string
- `count` string
- `email_substring` string
- `include_closed_users` string
- `permissions` string
- `start_position` string
- `task_source` string
- `task_type` string
- `user_name_substring` string

## Response `200`

Successful response.

## Other responses

- `400`: Error encountered.

## Changes

- **2026-07-13** (v2) `77f1998c313d`: 2 info
  - added the new optional `query` request parameter `task_source`
  - added the new optional `query` request parameter `task_type`
- **2023-05-19** (v2) `08b5c5881e49`: 1 info
  - added the new optional `query` request parameter `include_closed_users`
- **2023-04-14** (v2) `6efbc3a0673b`: 1 info
  - endpoint added
- **2019-07-18** (v2) `8ad1b5a40f1b`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/changes/v2.1/accounts/:accountId/users/:userId/authorizations/get.md)

---

[API](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api.md) - [All operations](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/docusign/apis/docusign-esignature-rest-api/revisions/77f1998c313d?raw)