---
title: "Get doc group recipients"
url: "https://docs.signnow.com/docs/doc-group-field-invite/operations/get-v2-document-groups-document_group_id-recipients"
type: "endpoint"
section: "doc-group-field-invite"
slug: "doc-group-field-invite/operations/get-v2-document-groups-document_group_id-recipients"
method: "GET"
path: "/v2/document-groups/{document_group_id}/recipients"
operation_id: "get-v2-document-groups-document_group_id-recipients"
authorization: "bearer"
---

# Get doc group recipients

`GET /v2/document-groups/{document_group_id}/recipients`

This endpoint retrieves the list of recipients for a document group invite.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `document_group_id` | string | Yes | ID of the document group. |

## Responses

### 200

Success with email group block

**Example** (`Example 1`)

```json
{
  "data": {
    "cc": [
      "cc_recipient1@email.com",
      "cc_recipient2@email.com"
    ],
    "order_type": null,
    "recipients": [
      {
        "name": "Buyer",
        "email": "buyer@email.com",
        "order": 1,
        "documents": [
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Buyer_viewer_role_id_05ffe410-4fbf-49be-a9a4-9583c11d1b40",
            "action": "view"
          },
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Buyer",
            "action": "sign"
          }
        ],
        "attributes": {
          "message": "Please contact for any questions",
          "subject": "Review and sign documents",
          "reminder": {
            "remind_after": 3,
            "remind_before": 5,
            "remind_repeat": 7
          },
          "redirect_uri": "https://example.com",
          "allow_reassign": "0",
          "authentication": {
            "type": "password",
            "value": "1233456"
          },
          "i_am_recipient": false,
          "expiration_days": 30,
          "redirect_target": "blank",
          "allow_forwarding": false,
          "close_redirect_uri": "https://close-redirect-uri.com",
          "show_decline_button": true,
          "decline_by_signature": 0,
          "decline_redirect_uri": "https://signnow.com"
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      },
      {
        "name": "Seller",
        "email": "seller@email.com",
        "order": 2,
        "documents": [
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Seller_viewer_role_id_ab14c5a0-aaac-4949-898c-12e7dba34d56",
            "action": "view"
          },
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Seller",
            "action": "sign"
          }
        ],
        "attributes": {
          "message": "Please contact for any questions",
          "subject": "Review and sign documents",
          "reminder": {
            "remind_after": 3,
            "remind_before": 5,
            "remind_repeat": 7
          },
          "redirect_uri": "https://example.com",
          "allow_reassign": "0",
          "authentication": {
            "type": "password",
            "value": "1233456"
          },
          "i_am_recipient": false,
          "expiration_days": 30,
          "redirect_target": "blank",
          "allow_forwarding": false,
          "close_redirect_uri": "https://close-redirect-uri.com",
          "show_decline_button": true,
          "decline_by_signature": 0,
          "decline_redirect_uri": "https://signnow.com"
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      },
      {
        "name": "Approver",
        "email": "approver@email.com",
        "order": 3,
        "documents": [
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Approver",
            "action": "approve"
          },
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Approver",
            "action": "approve"
          }
        ],
        "attributes": {
          "email": "approver@email.com",
          "message": "Please contact for any questions",
          "subject": "Review and approve documents",
          "document_id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
          "redirect_uri": "https://www.signnow.com/",
          "authentication": {
            "type": "password",
            "value": "1233456"
          },
          "expiration_days": 30
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      },
      {
        "name": "Viewer",
        "email": "viewer@email.com",
        "order": 4,
        "documents": [
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Viewer_viewer_role_id_57ae5e63-ff8e-40fc-9452-a4296b6d7353",
            "action": "view"
          },
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Viewer_viewer_role_id_d11e1726-8366-4fde-8354-e3dfece72ad8",
            "action": "view"
          }
        ],
        "attributes": {
          "message": "Please contact for any questions",
          "subject": "Review documents"
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      }
    ],
    "general_reminder": {
      "remind_after": 3,
      "remind_before": 5,
      "remind_repeat": 7
    },
    "unmapped_documents": [
      {
        "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
        "role": "Viewer",
        "action": "view"
      },
      {
        "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
        "role": "Buyer",
        "action": "view"
      },
      {
        "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
        "role": "Seller",
        "action": "view"
      },
      {
        "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
        "role": "Viewer",
        "action": "view"
      }
    ],
    "general_expiration_days": 30,
    "allowed_unmapped_sign_documents": []
  }
}
```

**Example** (`Success with signers, viewers, approvers`)

```json
{
  "data": {
    "cc": [
      "cc_recipient1@email.com",
      "cc_recipient2@email.com"
    ],
    "order_type": null,
    "recipients": [
      {
        "name": "Buyer",
        "email": "buyer@email.com",
        "order": 1,
        "documents": [
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Buyer_viewer_role_id_05ffe410-4fbf-49be-a9a4-9583c11d1b40",
            "action": "view"
          },
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Buyer",
            "action": "sign"
          }
        ],
        "attributes": {
          "message": "Please contact for any questions",
          "subject": "Review and sign documents",
          "reminder": {
            "remind_after": 3,
            "remind_before": 5,
            "remind_repeat": 7
          },
          "redirect_uri": "https://example.com",
          "allow_reassign": "0",
          "authentication": {
            "type": "password",
            "value": "1233456"
          },
          "i_am_recipient": false,
          "expiration_days": 30,
          "redirect_target": "blank",
          "allow_forwarding": false,
          "close_redirect_uri": "https://close-redirect-uri.com",
          "show_decline_button": true,
          "decline_by_signature": 0,
          "decline_redirect_uri": "https://signnow.com"
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      },
      {
        "name": "Seller",
        "email": "seller@email.com",
        "order": 2,
        "documents": [
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Seller_viewer_role_id_ab14c5a0-aaac-4949-898c-12e7dba34d56",
            "action": "view"
          },
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Seller",
            "action": "sign"
          }
        ],
        "attributes": {
          "message": "Please contact for any questions",
          "subject": "Review and sign documents",
          "reminder": {
            "remind_after": 3,
            "remind_before": 5,
            "remind_repeat": 7
          },
          "redirect_uri": "https://example.com",
          "allow_reassign": "0",
          "authentication": {
            "type": "password",
            "value": "1233456"
          },
          "i_am_recipient": false,
          "expiration_days": 30,
          "redirect_target": "blank",
          "allow_forwarding": false,
          "close_redirect_uri": "https://close-redirect-uri.com",
          "show_decline_button": true,
          "decline_by_signature": 0,
          "decline_redirect_uri": "https://signnow.com"
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      },
      {
        "name": "Approver",
        "email": "approver@email.com",
        "order": 3,
        "documents": [
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Approver",
            "action": "approve"
          },
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Approver",
            "action": "approve"
          }
        ],
        "attributes": {
          "email": "approver@email.com",
          "message": "Please contact for any questions",
          "subject": "Review and approve documents",
          "document_id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
          "redirect_uri": "https://www.signnow.com/",
          "authentication": {
            "type": "password",
            "value": "1233456"
          },
          "expiration_days": 30
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      },
      {
        "name": "Viewer",
        "email": "viewer@email.com",
        "order": 4,
        "documents": [
          {
            "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
            "role": "Viewer_viewer_role_id_57ae5e63-ff8e-40fc-9452-a4296b6d7353",
            "action": "view"
          },
          {
            "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
            "role": "Viewer_viewer_role_id_d11e1726-8366-4fde-8354-e3dfece72ad8",
            "action": "view"
          }
        ],
        "attributes": {
          "message": "Please contact for any questions",
          "subject": "Review documents"
        },
        "email_group": {
          "id": null
        },
        "phone_invite": null
      }
    ],
    "general_reminder": {
      "remind_after": 3,
      "remind_before": 5,
      "remind_repeat": 7
    },
    "unmapped_documents": [
      {
        "id": "4c67456dc7d3430ba89514667ce4f32da7b33f76",
        "role": "Viewer",
        "action": "view"
      },
      {
        "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
        "role": "Buyer",
        "action": "view"
      },
      {
        "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
        "role": "Seller",
        "action": "view"
      },
      {
        "id": "77f637a5dc3d47c4ba574a86b573a0562a07cc77",
        "role": "Viewer",
        "action": "view"
      }
    ],
    "general_expiration_days": 30,
    "allowed_unmapped_sign_documents": []
  }
}
```

### 400

	
Request with any of cases:

- incorrect token of user
- expired token of user
- empty header
- authorization = null
- authorization without value

**Example** (`Authorization issues`)

```json
{
  "code": 1537,
  "message": "invalid_token"
}
```

### 403

Access to DocumentGroup is denied

**Example** (`Access to DocumentGroup is denied`)

```json
{
  "errors": [
    {
      "message": "Access to DocumentGroup is denied"
    }
  ]
}
```

### 404

Request with any of cases:

- Document Group is not found
- Document with incorrect UID

**Example** (`Group not found or incorrect ID`)

```json
{
  "errors": [
    {
      "code": 0,
      "message": "Document group `b1XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX` not found"
    }
  ]
}
```

## Code Examples

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

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/v2/document-groups/{document_group_id}/recipients" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/doc-group-field-invite/operations/get-v2-document-groups-document_group_id-recipients*