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

# List Sent Emails

> List all sent emails with pagination.

<ParamField query="page" type="integer" default="1">
  Page number.
</ParamField>

<ParamField query="per_page" type="integer" default="50">
  Number of emails per page (max 100).
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `queued`, `sent`, `delivered`, `bounced`, `complained`.
</ParamField>

### Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.unosend.co/emails?page=1&per_page=10" \
    -H "Authorization: Bearer un_xxxxxxxxxx"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.unosend.co/emails?page=1&per_page=10', {
    headers: { 'Authorization': 'Bearer un_xxxxxxxxxx' }
  });
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get('https://api.unosend.co/emails',
    headers={'Authorization': 'Bearer un_xxxxxxxxxx'},
    params={'page': 1, 'per_page': 10}
  )
  data = response.json()
  ```

  ```go Go theme={null}
  req, _ := http.NewRequest("GET", "https://api.unosend.co/emails?page=1&per_page=10", nil)
  req.Header.Set("Authorization", "Bearer un_xxxxxxxxxx")
  resp, _ := http.DefaultClient.Do(req)
  ```

  ```php PHP theme={null}
  $ch = curl_init('https://api.unosend.co/emails?page=1&per_page=10');
  curl_setopt_array($ch, [
      CURLOPT_HTTPHEADER => ['Authorization: Bearer un_xxxxxxxxxx'],
      CURLOPT_RETURNTRANSFER => true
  ]);
  $response = curl_exec($ch);
  ```

  ```ruby Ruby theme={null}
  require 'net/http'
  uri = URI('https://api.unosend.co/emails?page=1&per_page=10')
  req = Net::HTTP::Get.new(uri)
  req['Authorization'] = 'Bearer un_xxxxxxxxxx'
  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
  ```
</CodeGroup>

### Response

```json 200 theme={null}
{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "from": "hello@yourdomain.com",
      "to": ["user@example.com"],
      "subject": "Hello World",
      "status": "delivered",
      "created_at": "2024-01-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "page_size": 10,
    "pages": 5
  }
}
```

<ResponseField name="success" type="boolean">Whether the request was successful.</ResponseField>

<ResponseField name="data" type="array">
  Array of email objects.

  <Expandable title="Email object">
    <ResponseField name="id" type="string">Unique email identifier.</ResponseField>
    <ResponseField name="from" type="string">Sender email address.</ResponseField>
    <ResponseField name="to" type="string[]">Recipient email addresses.</ResponseField>
    <ResponseField name="subject" type="string">Email subject line.</ResponseField>
    <ResponseField name="status" type="string">Delivery status: `queued`, `sent`, `delivered`, `bounced`, `complained`.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Pagination metadata.

  <Expandable title="meta object">
    <ResponseField name="total" type="integer">Total number of emails.</ResponseField>
    <ResponseField name="page" type="integer">Current page number.</ResponseField>
    <ResponseField name="page_size" type="integer">Number of results per page.</ResponseField>
    <ResponseField name="pages" type="integer">Total number of pages.</ResponseField>
  </Expandable>
</ResponseField>
