> ## Documentation Index
> Fetch the complete documentation index at: https://agents.nanonets.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# DocuSign Get Envelope

> Envelope status lookup tool exposed through the Agents Platform.

This document covers `docusign_get_envelope`, the envelope status lookup tool exposed through the Agents Platform.

## Authentication

DocuSign tools use the DocuSign connector, which authenticates with **JWT Grant** (server-to-server). Users configure `integration_key`, `user_id` and `private_key`, plus optional `account_id` and `environment`. See [docusign.md](/docs/tools/docusign) for setup and the one-time admin consent step.

## `docusign_get_envelope`

Reads a DocuSign envelope's current state by id. This is a read-only tool.

### Inputs

Required:

* `envelope_id`: Id of the envelope, as returned by [docusign\_send\_envelope](/docs/tools/docusign-send-envelope).

### Status values

| Status      | Meaning                                               |
| ----------- | ----------------------------------------------------- |
| `created`   | A draft that was never sent — no one has been emailed |
| `sent`      | Delivered to the signer, awaiting signature           |
| `delivered` | The signer opened it (not signed)                     |
| `completed` | Every signer has signed                               |
| `declined`  | A signer refused                                      |
| `voided`    | Cancelled; `voided_reason` explains why               |

`delivered` is the one most often misread: it means opened, **not** signed. Only `completed` means the document is done.

### Output

Structured content includes:

* `envelope_id`
* `envelope`: full envelope object — subject, and the sent / delivered / completed / declined / voided timestamps
* `envelope_status`: the raw status string, lifted out
* `is_completed`: boolean, true only for `completed`

`envelope_status` and `is_completed` are surfaced at the top level so a decision step can branch without reaching into a nested object.

### Notes

* Call this before re-sending anything. Sending is billed per envelope and cannot be undone, and this is the only way to know an envelope already exists.
* Polling this tool is currently how envelope lifecycle changes are observed; DocuSign Connect webhooks are not wired up yet.