Skip to contentSkip to navigationSkip to topbar
Twilio SendGrid Docs
Page tools
Useful for sharing or LLM
On this page
Looking for more inspiration?Visit the

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.

Key endpoints

key-endpoints page anchor
  • Filter All Messages: Retrieve stored messages with filtering (POST request)
  • Filter by Message ID: Drill into event history for a specific message (GET request)

Usage notes

usage-notes page anchor
  • 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.

Authentication

authentication page anchor

All endpoints require API Key authentication through the Authorization: Bearer <API_KEY> header.

Response

response page anchor

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.