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

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

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

## Request

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

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

If the calling user is an account administrator, the full results will be returned. Otherwise, only authorizations for which the calling user is the principal user will be returned.

## 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/agent/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)