Email Logs

Email logs

List and retrieve email sending logs for the account.

List email logs

get

Returns a paginated list of email logs (messages) for the account. Results are restricted to sending domains the authenticated token has access to. Invalid or unknown filters are ignored. Results are ordered by sent_at descending.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

Query parameters

search_afterstring · uuidOptional

Cursor for the next page (message_id UUID from previous response next_page_cursor).

Responses

200

Success

application/json

total_countintegerRequired

Total number of messages matching the filters (before pagination).

next_page_cursorstring · uuid · nullableRequired

Message UUID to use as search_after for the next page. Null if no more pages.

400

Bad request - invalid parameters.

application/json

401

Unauthorized. Check your API credentials.

application/json

404

Resource not found

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/email_logs

cURL

curl -X GET -g 'https://mailtrap.io/api/accounts/{account_id}/email_logs?filters[sent_after]=2025-01-01T00:00:00Z&filters[sent_before]=2025-01-31T23:59:59Z&filters[to][operator]=ci_equal&filters[to][value][email protected]&filters[sending_domain_id][operator]=equal&filters[sending_domain_id][value]=3938' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "messages": [
    {
      "message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "delivered",
      "subject": "Welcome to our service",
      "from": "[email protected]",
      "to": "[email protected]",
      "sent_at": "2025-01-15T10:30:00Z",
      "client_ip": "203.0.113.42",
      "category": "Welcome Email",
      "custom_variables": {},
      "sending_stream": "transactional",
      "sending_domain_id": 3938,
      "template_id": 100,
      "template_variables": {},
      "opens_count": 2,
      "clicks_count": 1
    },
    {
      "message_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "status": "delivered",
      "subject": "Your order confirmation",
      "from": "[email protected]",
      "to": "[email protected]",
      "sent_at": "2025-01-15T11:00:00Z",
      "client_ip": null,
      "category": "Order Confirmation",
      "custom_variables": {
        "order_id": "12345"
      },
      "sending_stream": "transactional",
      "sending_domain_id": 3938,
      "template_id": null,
      "template_variables": {},
      "opens_count": 0,
      "clicks_count": 0
    }
  ],
  "total_count": 150,
  "next_page_cursor": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
}

Get an email log message by ID

get

Returns a single message by message UUID. Message must belong to the account and a sending domain the token can access.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

API token in Api-Token header

Path parameters

account_idintegerRequired

Account ID

Example: 1

sending_message_idstring · uuidRequired

Message UUID

Responses

200

Success

application/json

message_idstring · uuidOptional

statusstring · enumOptionalPossible values:

subjectstring · nullableOptional

fromstringOptional

tostringOptional

sent_atstring · date-timeOptional

client_ipstring · nullableOptional

categorystring · nullableOptional

custom_variablesobjectOptional

sending_streamstring · enumOptionalPossible values:

sending_domain_idintegerOptional

template_idinteger · nullableOptional

template_variablesobjectOptional

opens_countintegerOptional

clicks_countintegerOptional

raw_message_urlstring · uriOptional

Signed URL to download raw .eml message (temporary).

401

Unauthorized. Check your API credentials.

application/json

404

Resource not found

application/json

429

Rate limit exceeded for the current account.

application/json

get

/api/accounts/{account_id}/email_logs/{sending_message_id}

cURL

curl -X GET 'https://mailtrap.io/api/accounts/{account_id}/email_logs/{sending_message_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "delivered",
  "subject": "Welcome to our service",
  "from": "[email protected]",
  "to": "[email protected]",
  "sent_at": "2025-01-15T10:30:00Z",
  "client_ip": "203.0.113.42",
  "category": "Welcome Email",
  "custom_variables": {},
  "sending_stream": "transactional",
  "sending_domain_id": 3938,
  "template_id": 100,
  "template_variables": {},
  "opens_count": 2,
  "clicks_count": 1,
  "raw_message_url": "https://storage.example.com/signed/eml/a1b2c3d4-e5f6-7890-abcd-ef1234567890?token=...",
  "events": [
    {
      "event_type": "click",
      "created_at": "2025-01-15T10:35:00Z",
      "details": {
        "click_url": "https://example.com/track/click/abc123",
        "web_ip_address": "198.51.100.50"
      }
    },
    {
      "event_type": "spam",
      "created_at": "2025-01-15T10:40:00Z",
      "details": {
        "spam_feedback_type": "abuse"
      }
    }
  ]
}