> For the complete documentation index, see [llms.txt](https://docs.systemsx.co.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.systemsx.co.uk/sense/api-email-history.md).

# API Email - History

## Search Emails History

<mark style="color:green;">`POST`</mark> `/v2/email/search`

**Body**

<table><thead><tr><th width="225">Param</th><th width="121">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>api_key</code></td><td>string</td><td><mark style="color:red;">required</mark></td></tr><tr><td><code>email_address</code></td><td>string</td><td>Email Address lookup <mark style="color:red;">required</mark></td></tr><tr><td><code>page</code></td><td>int</td><td></td></tr><tr><td><code>uuid</code></td><td>string</td><td>Return Single Email From UUID</td></tr><tr><td><code>eid</code></td><td>string</td><td>Return Emails from eid [Chain]</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "current_page": 1,
    "from": 1,
    "to": 1,
    "total": 4,
    "data": [
        {
            "id": 1,
            "uuid": "14e60762992ef2aeb13038a8fb08ffd5",
            "user_id": 1,
            "agent_id": 1000,
            "hidden": 0,
            "provider": "outlook", // outlook, gmail or smtp
            "folder": "Inbox",
            "type": "inbound", // inbound or outbound
            "eid": "EMAIL_CHAIN_ID_HERE",
            "uid": "UNIWUE_EMAIL_ID_HERE",
            "from_email": "from@email.com",
            "to_email": [
                {
                    "name": "John Doe",
                    "email_address": "to@email.com"
                }
            ],
            "subject": "Sending Email Eample",
            "text_body": "BASE_64_ENCODED_STRING",
            "html_body": "BASE_64_ENCODED_STRING",
            "headers": [
                { // Possible outputs, custom to whats sent.
                    "sense_customer_id": 123456,
                    "sense_order_id": 123456
                    // ...
                }
            ],
            "cc": [
                {
                    "name": "Another Person",
                    "email_address": "cc1@email.com"
                }
            ],
            "bcc": [], // Same pattern as CC
            "is_draft": 0, // True/False
            "is_read": 1, // True/False
            "summary": "Summary of the Email Chain here",
            "actions": [
                {
                    "type": "email",
                    "task": "Example task here",
                    "period": "ASAP" // TODAY, ASAP, THIS_WEEK, NEXT_WEEK or Specific Date [YYYY-MM-DD H:i:s]
                }
            ],
            "spam": 0, // 0-100
            "scam": 0, // 0-100
            "junk": 0, // 0-100
            "tags": [
                "technical",
                "b2b",
                "internal",
                "follow_up",
                "product_update"
            ],
            "priority": "medium", // low, medium, high
            "date": "2024-11-21 18:51:03", // Date the email landed
            "created_at": "2024-11-21T23:15:33.000000Z",
            "updated_at": "2024-11-21T23:15:48.000000Z"
        },
    ],
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid request"
}
```

{% endtab %}
{% endtabs %}