Own DocuSign? Customize your docs with AI search, analytics, and more.

Claim your docs

GET

Gets information about groups associated with the account.

https://www.docusign.com/v2.1/accounts/{accountId}/groups

Gets information about groups associated with the account. <ds-inlinemessage kind="information" markdown="1"> To get the users in a group: 1. Use this endpoint to get the group ID. 2. Use listGroupUsers to get the list of users. </ds-inlinemessage> ### Related topics - How to set a permission profile

Access Token Required: API Key

Path Parameters

accountIdstringrequired

The external account number (int) or account ID GUID.

Query Params

countstring

The maximum number of results to return. Use `start_position` to specify the number of results to skip. Valid values: `1` to `100`

group_typestring

The type of group to return. Valid values: * `AdminGroup` * `CustomGroup` * `EveryoneGroup`

include_usercountstring

When **true,** every group returned in the response includes a `userCount` property that contains the total number of users in the group. The default is **true.**

search_textstring

Filters the results of a GET request based on the text that you specify.

start_positionstring

The zero-based index of the result from which to start returning results. Use with `count` to limit the number of results. The default value is `0`.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

curl --request GET \
     --url 'https://www.docusign.com/v2.1/accounts/{accountId}/groups' \
     --header 'accept: application/json' \
     --header 'content-type: application/json'

Response

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

GET