# Envelopes

> Additional envelope operations beyond creating, distributing, and checking status.

The [Integration Guide](/en/guides/integration-guide/) covers the minimal flow: create, distribute, check status, and download. This resource documents the rest of the operations on an envelope — listing with filters, updating, cancelling, duplicating, resending, and fetching several at once.

## List envelopes

```http
GET /envelope
```

Returns a paginated list. Accepts these query parameters:

| Parameter | Values | Description |
|---|---|---|
| `query` | text | Free-text search across title and other indexed fields. |
| `page` / `perPage` | number | Pagination (`perPage` defaults to 10). |
| `type` | `DOCUMENT`, `TEMPLATE` | Filter by envelope type. |
| `templateId` | number | Only envelopes created from that template. |
| `source` | `DOCUMENT`, `TEMPLATE`, `TEMPLATE_DIRECT_LINK` | Filter by creation source. |
| `status` | `DRAFT`, `PENDING`, `COMPLETED`, `REJECTED`, `CANCELLED` | Filter by status. |
| `hasExpiredRecipients` | `true`, `false` | Only envelopes with a recipient whose signing link expired. |
| `folderId` | string | Filter by folder. |
| `orderByColumn` / `orderByDirection` | `createdAt` / `asc`, `desc` | List ordering. |

See the full spec in the [API Reference](/en/api/operations/envelope-find/).

## Get multiple envelopes

```http
POST /envelope/get-many
```

Takes an `ids` array and returns each one's detail in a single call — useful to avoid N calls to `GET /envelope/{envelopeId}` when you already have the IDs (for example, after creating several documents from a template).

See the full spec in the [API Reference](/en/api/operations/envelope-getmany/).

## Update an envelope

```http
POST /envelope/update
```

Modifies `data` (envelope properties like `title` or `externalId`) and/or `meta` (subject, message, `redirectUrl`, etc.) on an existing envelope. Only takes effect while the envelope is in `DRAFT` — once distributed, these properties are fixed.

See the full spec in the [API Reference](/en/api/operations/envelope-update/).

## Cancel an envelope

```http
POST /envelope/cancel
```

Cancels an in-progress envelope (`DRAFT` or `PENDING`), with an optional `reason`. Unlike a rejection (initiated by a recipient), cancellation is initiated by the envelope's owner.

See the full spec in the [API Reference](/en/api/operations/envelope-cancel/).

## Delete an envelope

```http
POST /envelope/delete
```

Deletes an envelope. A `COMPLETED` envelope can't be deleted — cancel it first if it hasn't reached that status yet.

See the full spec in the [API Reference](/en/api/operations/envelope-delete/).

## Duplicate an envelope

```http
POST /envelope/duplicate
```

Creates a copy of an existing envelope. The `includeRecipients` and `includeFields` flags control whether the copy also brings the original recipients and fields, or starts blank to configure from scratch.

See the full spec in the [API Reference](/en/api/operations/envelope-duplicate/).

## Resend to pending recipients

```http
POST /envelope/redistribute
```

Re-notifies specific recipients of an already-distributed envelope — for example, if they missed the original email or their link expired. Takes `recipients`, the list of recipients to re-notify.

See the full spec in the [API Reference](/en/api/operations/envelope-redistribute/).

---

## See also

- [Recipients](/en/resources/recipients/) — adding and managing who signs
- [Fields](/en/resources/fields/) — field types and their options
- [Templates](/en/resources/templates/) — creating reusable envelopes