Returns the ordered event timeline for one message — queued, sent, delivered, bounced, opened, clicked, and related SMTP/DSN detail.
Pass the trackingId from Send a transactional email or the messageId from a search row.
Set include_content=true to include HTML/text body on timeline events (list/search omit body by default).
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns the ordered event timeline for one email message — each row is a delivery or engagement event with optional SMTP diagnostics.
Authentication
Authorization: Bearer {access_token} with scope transactional_email or all. No Principal header.
Path and query
| Parameter | Location | Description |
|---|---|---|
trackingId | path | Id from Send a transactional email response, or messageId from search results |
include_content | query | Default false. Set true to include HTML/text body on events |
Example — cURL
curl -X GET 'https://connect.routee.net/email/tracking/single/51b1738c-5fc5-4aa2-85a4-3b063c486cd7?include_content=false' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'Response
JSON array of tracking events (not a page). Typical progression:
event / deliveryStatus | Meaning |
|---|---|
QUEUED | Accepted by Routee mail pipeline |
SENT / DELIVERED | Handed off or confirmed by recipient MTA |
BOUNCED / FAILED | Permanent or temporary failure |
| Open/click events | Present when callback.eventCallback was configured on send |
Extra fields on timeline rows
| Field | Description |
|---|---|
results | SMTP delivery attempts (status, description, DSN flag) |
dsn | Delivery Status Notification payload when available |
callbackBody | Metadata from open/click callbacks (IP, device, etc.) |
content | Message body when include_content=true |
IDs
| Id | Where it appears | Use |
|---|---|---|
trackingId | Send response; tracking rows | Preferred lookup key from integrator code |
messageId | Every tracking row | Internal log key; also accepted on this endpoint |
See Transactional Email API v2 overview for the full id glossary.
Missing or invalid Bearer token
Insufficient role or OAuth scope (transactional_email required)
Message not found for this account