---
title: "Get pending group invites"
url: "https://docs.signnow.com/docs/doc-group-field-invite/operations/get-pending-document-group-invites"
type: "endpoint"
section: "doc-group-field-invite"
slug: "doc-group-field-invite/operations/get-pending-document-group-invites"
method: "GET"
path: "/documentgroup/{document_group_id}/groupinvite/{invite_id}/pendinginvites"
operation_id: "get-pending-document-group-invites"
authorization: "bearer"
---

# Get pending group invites

`GET /documentgroup/{document_group_id}/groupinvite/{invite_id}/pendinginvites`

This endpoint allows users to retrieve all pending document group invite information.
If the caller is the document owner, the response includes both pending invites for that user and all fulfilled actions for the entire group invite.


Possible invite actions are:
- `sign`: The recipient can sign or fill out the document.
- `approve`: The recipient can review the document to approve or decline it.
- `view`: The recipient can only review the document without making changes.

## Authorization

bearer

## Path Parameters

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

## Responses

### 200

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

```json
{
  "invites": [
    {
      "link": "https://example.com/cdXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "action": "sign",
      "status": "fulfilled",
      "document_name": "Sample Document",
      "inviter_email": "signer1@email.com"
    },
    {
      "link": "https://example.com/ddXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "action": "sign",
      "status": "pending",
      "document_name": "Contract 2",
      "inviter_email": "signer2@email.com"
    }
  ],
  "document_group_name": "Contracts"
}
```

## Code Examples

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

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/documentgroup/{document_group_id}/groupinvite/{invite_id}/pendinginvites" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/doc-group-field-invite/operations/get-pending-document-group-invites*