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).
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 rows for this batch (send response trackingId) or a single message (messageId also accepted) |
page | No | 0 | Zero-based page index |
size | No | 20 | Page size (minimum 1) |
Prefer ?trackingId= to look up one batch instead of a body filter.
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, trackingId, messageId, type, label, tags |
searchTerm | Value to match |
searchOperator | is, is_not, contains, starts_with, ends_with |
Filter tips:
fieldName | Use for |
|---|---|
trackingId | Batch id from send response (same as query ?trackingId=) |
messageId | Per-recipient worker id |
type | Send path — API, SMTP, or MARKETING |
label / tags | Campaign / send tag from TE label (exact, case-sensitive match). Use your Waymore campaign id here for one-by-one campaign grouping. |
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"}]'Look up one batch by id:
curl -X POST 'https://connect.routee.net/email/tracking?trackingId=51b1738c-5fc5-4aa2-85a4-3b063c486cd7' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-d '[]'Filter by campaign label (TE send-time tag):
curl -X POST 'https://connect.routee.net/email/tracking?page=0&size=50' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-d '[{"fieldName":"label","searchTerm":"waymore-campaign-42","searchOperator":"is"}]'Response fields (each item in content)
content)| Field | Description |
|---|---|
trackingId | Batch id from send — use for batch summary and recipient timeline path |
messageId | Per-recipient id — worker log key; use for recipient timeline |
recipient, from, subject | Envelope summary |
status, deliveryStatus, event | Latest human-readable and MTA status |
channel | API or SMTP (send path); MARKETING for promo campaigns |
date | Event timestamp (UTC) |
openedCount, clickCount | Engagement counters |
tags | Tags from send metadata |
For the full event timeline (queued → sent → delivered → …):
- Batch send (multiple
toaddresses): Get email tracking (batch summary) → Get email tracking (recipient timeline) - Single message / legacy: 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)