---
title: "Gets the status of recipients for an envelope."
method: GET
path: "/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients"
tags: ["EnvelopeRecipients"]
---

# Gets the status of recipients for an envelope.

`GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients`

## Request

- Base URL: `https://www.docusign.net/restapi`
- URL: `https://www.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients`
- Auth: none declared

Retrieves the status of all recipients in a single envelope and identifies the current recipient in the routing list. This method can also be used to retrieve the tab values.

The `currentRoutingOrder` property of the response contains the `routingOrder` value of the current recipient indicating that the envelope has been sent to the recipient, but the recipient has not completed their actions.

### Related topics

- [How to list envelope recipients](/docs/esign-rest-api/how-to/get-envelope-recipients/)
- [How to retrieve ID Evidence events](/docs/idevidence-api/how-to/retrieve-idevidence-events/)
- [How to retrieve ID Evidence media](/docs/idevidence-api/how-to/retrieve-idevidence-media/)

## Path parameters

- `accountId` string, required
- `envelopeId` string, required

## Query parameters

- `include_anchor_tab_locations` string
- `include_extended` string
- `include_metadata` string
- `include_tabs` string

## Response `200`

Successful response.

## Other responses

- `400`: Error encountered.

---

[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)
