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

# List Envelopes

> Retrieve email envelope metadata

## Description

Retrieve paginated envelope metadata for emails sent from your verified domains.

## Query parameters

<ParamField query="limit" type="number">
  Results per page. Default: 20. Maximum: 100.
</ParamField>

<ParamField query="page" type="number">
  Page number. Default: 1.
</ParamField>

<ParamField query="search" type="string">
  Search by sender, subject, or envelope ID.
</ParamField>

<ParamField query="start_date" type="string">
  Filter envelopes created on or after this date.
</ParamField>

<ParamField query="end_date" type="string">
  Filter envelopes created on or before this date.
</ParamField>

<ParamField query="sort_by" type="string" enum="['from_email', 'created_at']">
  Sort field. Default: `created_at`.
</ParamField>

<ParamField query="sort_order" type="string" enum="['asc', 'desc']">
  Sort order. Default: `desc`.
</ParamField>

## Response

<ResponseField name="data" type="array">
  Array of email envelope records.
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata.
</ResponseField>

### Envelope object

<ResponseField name="id" type="string">
  Unique envelope ID.
</ResponseField>

<ResponseField name="subject" type="string">
  Email subject.
</ResponseField>

<ResponseField name="from_email" type="string">
  Sender email address.
</ResponseField>

<ResponseField name="from_name" type="string | null">
  Sender name, if provided.
</ResponseField>

<ResponseField name="total_recipients" type="number">
  Number of recipients included in the email.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp when the envelope was created.
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.usesendly.app/v1/emails/envelope?limit=20&page=1" \
    -H "Authorization: Bearer se_your_api_key"
  ```

  ```javascript SDK theme={null}
  const response = await client.emails.envelope.list({
    limit: 20,
    page: 1,
    sort_by: 'created_at',
    sort_order: 'desc'
  })

  response.data.forEach(env => {
    console.log(`From: ${env.from_name || env.from_email}`)
    console.log(`Subject: ${env.subject}`)
  })
  ```
</CodeGroup>

***

Need help? Contact [support@usesendly.app](mailto:support@usesendly.app)