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

# Sent emails and delivery status

> Track delivery outcomes, open and click events, and troubleshoot failed sends.

Every email dispatched by MailerPath generates a sent email record. Use these records to verify delivery, track engagement, and debug issues.

## Sent email statuses

| Status      | Meaning                                                           |
| ----------- | ----------------------------------------------------------------- |
| `queued`    | Email is waiting to be dispatched.                                |
| `sent`      | Accepted by the email provider.                                   |
| `delivered` | Confirmed delivery by provider or webhook.                        |
| `opened`    | Recipient opened the email (tracking pixel fired).                |
| `clicked`   | Recipient clicked a tracked link.                                 |
| `deferred`  | Provider temporarily delayed delivery — will retry automatically. |
| `bounced`   | Hard or soft bounce received from provider.                       |
| `failed`    | Dispatch failed after retries.                                    |
| `skipped`   | Contact was unsubscribed, suppressed, or rate-limited.            |

## Where sent emails come from

Sent email records are created by:

* Transactional send via `POST /client/send`
* Workflow action steps that dispatch an email
* Campaign sends to a batch of recipients

Each record is linked to its source: the campaign, workflow execution, or direct send request.

## How status updates work

Initial status at creation is `queued` or `sent`.

Status changes are driven by:

* Email provider acknowledgment (delivery confirmation)
* Inbound webhook events (open, click, bounce, complaint)

MailerPath processes these webhook events and updates the sent email record accordingly.

## Filtering and searching sent emails

You can retrieve sent emails filtered by:

* Contact ID
* Status
* Date range (`from` and `to` in RFC3339 format)
* Campaign ID

Use `GET /client/sent-emails` to list records or `GET /client/sent-emails/{id}` to retrieve a specific one.

## Reading a sent email record

Key fields to understand:

* `status` and `status_text`: current delivery state and human-readable label.
* `provider_message_id`: the ID returned by the email provider for cross-referencing delivery logs.
* `error_message`: reason for failure if status is `failed` or `bounced`.
* `opened_at`, `clicked_at`, `delivered_at`: timestamps for engagement milestones.
* `attempt_count` and `last_attempt_at`: retry history for failed records.
* `contact_id` and `contact_email`: the recipient linked to the record.

## Troubleshooting delivery issues

**Status shows `deferred`**

* The provider accepted the email but delayed delivery temporarily.
* MailerPath will retry automatically.
* If the email stays deferred for an extended period, check provider logs for rate limiting or recipient-side filtering.

**Email not delivered**

* Check `error_message` on the sent email record.
* Verify sender domain is verified in your provider settings.
* Confirm the contact is subscribed.

**Status stuck at `queued`**

* Check provider configuration under [Settings](/documentation/settings/overview).
* Verify API key is enabled and has send permissions.

**High bounce rate**

* Review contact import quality: see [Contacts](/documentation/core-functionalities/contacts).
* Audit the domain sending configuration.

**Open rate unexpectedly low**

* Open tracking requires that the template includes the view in browser or tracking link.
* Check template variable resolution for `viewInBrowserUrl`.

For common error patterns and fixes, see [Common API issues](/documentation/troubleshooting/common-api-issues).