Returns a paginated list of email log rows for your account (latest event per message when browsing the full list).
Optional query trackingId narrows results to one message's timeline (same data shape as list, filtered).
Request body accepts zero or more search filters (same pattern as SMS tracking). Combine with dateStart / dateEnd (ISO-8601, UTC) to bound the time window.
Log rows may take 1–2 minutes to appear after a successful send.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns paginated email log rows for your account — one row per message showing the latest delivery event (same pattern as SMS tracking search).
Use optional query trackingId to fetch all events for a single message instead of browsing the full list.
Authentication
Authorization: Bearer {access_token} with scope transactional_email or all. Account OAuth token only. No Principal header.
Query parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
dateStart | No | — | ISO-8601 start of range (UTC) |
dateEnd | No | — | ISO-8601 end of range (UTC) |
trackingId | No | — | When set, returns timeline rows for this id (send trackingId or messageId) |
page | No | 0 | Zero-based page index |
size | No | 20 | Page size (minimum 1) |
Request body — search filters
JSON array of filter objects. Pass [] when no extra filters are needed.
| Field | Description |
|---|---|
fieldName | One of deliveryStatus, date, event, envelope, recipient, from, to, subject, status, messages, routeeCampainId |
searchTerm | Value to match |
searchOperator | is, is_not, contains, starts_with, ends_with |
Example — cURL
curl -X POST 'https://connect.routee.net/email/tracking?page=0&size=20&dateStart=2026-07-01T00:00:00Z&dateEnd=2026-07-06T23:59:59Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-d '[{"fieldName":"recipient","searchTerm":"[email protected]","searchOperator":"is"}]'Response fields (each item in content)
content)| Field | Description |
|---|---|
messageId | Internal message identifier |
trackingId | Routee correlation id from send; use for single-message lookup |
recipient, from, subject | Envelope summary |
status, deliveryStatus, event | Latest human-readable and MTA status |
channel | TRANSACTIONAL or MARKETING |
date | Event timestamp (UTC) |
openedCount, clickCount | Engagement counters |
tags | Tags from send metadata |
For the full event timeline (queued → sent → delivered → …), call Get email tracking (single message timeline).
Log rows may take 1–2 minutes to appear after send.
Missing or invalid Bearer token
Insufficient role or OAuth scope (transactional_email required)