Email Logs
The Email Logs API provides structured, event-level visibility into the lifecycle of every email sent through your email account. It enables you to search, filter, and retrieve event-level data to troubleshoot delivery issues and verify message outcomes in near real time.
- Filter All Messages: Retrieve stored messages with filtering (
POSTrequest) - Filter by Message ID: Drill into event history for a specific message (
GETrequest)
- Data Retention: All email customers will have access to 30 days of email event history. There are no options to extend the data retention period beyond 30 days.
- Compliance: Regional data stores ensure that logs originating from EU subaccounts remain within EU-based infrastructure. Accessing or processing data from outside the original region could be treated as global processing and may risk internal compliance requirements.
- Query Format: The API accepts a JSON request body containing a query string. Queries are case-sensitive and must use valid field names and operators.
- Pagination: Pagination is not supported. Limit results using the limit parameter.
All endpoints require API Key authentication through the Authorization: Bearer <API_KEY> header.
Endpoints return JSON that contains message details and events. The API returns accurate and consistent data structures for downstream use, aligning with the Event Webhook data solution.