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

# List all envelopes

Returns a list of envelopes associated with your organisation.

Envelopes are sorted in descending order by their creation date, with the most recently created appearing first.

By default, envelopes with a status of `draft` will not be returned unless the `status` parameter is explicitly provided.

Date parameters must be supplied in ISO 8601 format. Dates submitted in an invalid format will be silently ignored.

The response is limited to a maximum of 1,000 results.

## Parameters

<ParamField path="name" type="optional">
  Exact-match filter based on the envelope's `name` property.
</ParamField>

<ParamField path="status" type="optional">
  Exact-match filter based on the envelope's `status`.

  Valid values include `draft`, `created`, `sent`, `completed`, and `voided`.
</ParamField>

<ParamField path="recipient" type="optional">
  Exact-match filter based on a recipient’s name or email address.

  When used, all recipients of the matching envelopes will still be returned in the response.
</ParamField>

<ParamField path="created_before" type="optional">
  Return envelopes created before the specified ISO 8601 timestamp.
</ParamField>

<ParamField path="created_after" type="optional">
  Return envelopes created after the specified ISO 8601 timestamp.
</ParamField>

<ParamField path="completed_before" type="optional">
  Return envelopes completed before the specified ISO 8601 timestamp.
</ParamField>

<ParamField path="completed_after" type="optional">
  Return envelopes completed after the specified ISO 8601 timestamp.
</ParamField>

<RequestExample>
  ```bash Endpoint theme={null}
  GET /v1/envelopes
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  [{
    "id": "7e8f68e4c6df9395cd7ff48d69d7e2c1",
    "name": "Non disclosure agreement",
    "message": "Lorem ipsum dolor sit amet.",
    "status": "completed",
    "shared": false,
    "created": "2019-12-17T05:30:00Z",
    "sent": "2019-12-17T05:30:00Z",
    "voided": null,
    "declined": null,
    "completed": "2019-12-17T05:30:00Z",
    "account_id": "c64ce66b70b21c03bfd5dfa0ab14b730",
    "group_id": "a5a885caee6286a54ad7bbd4ab5400e9",
    "recipients": [{
      "id": "255e591c2c9fe1bc99be1ec03075b402",
      "name": "Ted Annature",
      "email": "ted@annature.com.au",
      "mobile": "+61422000000",
      "type": "signer",
      "status": "completed",
      "message": "Lorem ipsum dolor sit amet.",
      "password": true,
      "muted": false,
      "order": 1,
      "declined_reason": null,
      "created": "2019-12-17T05:30:00Z",
      "sent": "2019-12-17T05:30:00Z",
      "declined": null,
      "completed": "2019-12-17T05:30:00Z",
      "redirects": {
        "session_completed": "https://..",
        "session_declined": "https://.."
      }
    }]
  }]
  ```
</ResponseExample>