---
title: "Search and list email messages with filters"
method: GET
path: "/v2/email/messages"
tags: ["email-messages-v2"]
---

# Search and list email messages with filters

`GET /v2/email/messages`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/email/messages`
- Auth: API key in header `X-Api-Key`

Supports filtering by campaign_id, recipient, status, and date range.
Results are paginated and sorted by most recent first.

## Query parameters

- `per_page` string
- `page` string
- `to_date` string
- `from_date` string
- `status` string
- `recipient` string
- `campaign_id` string

## Response `200`

Success

- EmailMessagesListResponse
  - `messages` EmailMessageResponse[]
    - `bounceCode` string: Bounce code if bounced
    - `campaignId` string: Campaign ID if sent via campaign
    - `createdAt` string, date-time: Record creation timestamp
    - `deliveredAt` string, date-time: Delivery timestamp
    - `id` string: Record ID
    - `messageId` string: Email message ID
    - `recipient` string: Recipient email address
    - `status` string: Delivery status
  - `pagination` object: Pagination info

## Other responses

- `401`: Authentication error

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)