---
title: "Get document groups"
url: "https://docs.signnow.com/docs/document-group/operations/get-user-documentgroups"
type: "endpoint"
section: "document-group"
slug: "document-group/operations/get-user-documentgroups"
method: "GET"
path: "/user/documentgroups"
operation_id: "get-user-documentgroups"
authorization: "bearer"
---

# Get document groups

`GET /user/documentgroups`

Returns back all document groups the user owns. 

The call is paginated by last_updated, so offset and limit query parameters are required:
1. Limit must be greater than 0 but less than or equal to 50.
2. Offset must be 0 or greater.

## Authorization

bearer

## Query Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `limit` | integer | Yes |  |
| `offset` | integer | Yes |  |

## Responses

### 200

**Example** (`application/json`)

```json
{
  "document_groups": [
    {
      "group_id": "bcXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "documents": [
        {
          "id": "19XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "name": "Sample document",
          "roles": [
            "Signer 1"
          ],
          "thumbnail": {
            "large": "https://example.com/document/19XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large",
            "small": "https://example.com/document/19XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small",
            "medium": "https://example.com/document/19XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium"
          },
          "has_credit_card_number": false
        },
        {
          "id": "6fXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "name": "Sample document 1",
          "roles": [
            "Employer Representative"
          ],
          "thumbnail": {
            "large": "https://example.com/document/6fXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large",
            "small": "https://example.com/document/6fXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small",
            "medium": "https://example.com/document/6fXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium"
          },
          "has_credit_card_number": false
        }
      ],
      "invite_id": "47XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "group_name": "Sample document group",
      "last_updated": "1563886628",
      "invite_status": "pending"
    },
    {
      "group_id": "30XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "documents": [
        {
          "id": "f5XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "name": "Sample document",
          "roles": [
            "Signer 1"
          ],
          "thumbnail": {
            "large": "https://example.com/document/f5XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large",
            "small": "https://example.com/document/f5XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small",
            "medium": "https://example.com/document/f5XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium"
          },
          "has_credit_card_number": false
        },
        {
          "id": "03XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "name": "Sample document 1",
          "roles": [
            "Employer Representative"
          ],
          "thumbnail": {
            "large": "https://example.com/document/03XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large",
            "small": "https://example.com/document/03XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small",
            "medium": "https://example.com/document/03XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium"
          },
          "has_credit_card_number": false
        }
      ],
      "invite_id": "3aXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "group_name": "Sample document group",
      "last_updated": "1549032635",
      "invite_status": "pending"
    },
    {
      "group_id": "60XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "documents": [
        {
          "id": "15XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "name": "Sample document 2",
          "roles": [
            "Signer 1",
            "signer 2"
          ],
          "thumbnail": {
            "large": "https://example.com/document/15XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large",
            "small": "https://example.com/document/15XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small",
            "medium": "https://example.com/document/15XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium"
          },
          "has_credit_card_number": false
        },
        {
          "id": "c3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
          "name": "Sample document 1",
          "roles": [
            "Signer 1",
            "signer 2"
          ],
          "thumbnail": {
            "large": "https://example.com/document/c3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=large",
            "small": "https://example.com/document/c3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=small",
            "medium": "https://example.com/document/c3XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/thumbnail?size=medium"
          },
          "has_credit_card_number": false
        }
      ],
      "invite_id": "62XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "group_name": "Sample document group",
      "last_updated": "1540294396",
      "invite_status": "pending"
    }
  ],
  "document_group_total_count": 3,
  "originator_organization_settings": [
    {
      "value": "https://example_2.com",
      "setting": "invite_completion_redirect_url"
    },
    {
      "value": "",
      "setting": "invite_decline_redirect_url"
    },
    {
      "value": "0",
      "setting": "required_preset_signature_name"
    },
    {
      "value": "0",
      "setting": "require_email_subject"
    },
    {
      "value": "0",
      "setting": "require_login_for_signing"
    },
    {
      "value": "0",
      "setting": "logout_on_signing"
    },
    {
      "value": "0",
      "setting": "front_end_session_length"
    },
    {
      "value": "0",
      "setting": "add_signature_stamp_with_name"
    },
    {
      "value": "0",
      "setting": "cfr_title_21_part_11"
    },
    {
      "value": "0",
      "setting": "require_authentication_for_invites"
    },
    {
      "value": "1",
      "setting": "document_guide"
    },
    {
      "value": "0",
      "setting": "disable_email_notifications"
    }
  ]
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/user/documentgroups" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/document-group/operations/get-user-documentgroups*