Returns the ordered event timeline for one recipient inside a batch send.
Path parameters:
trackingId— batch id from the send responsemessageId— per-recipient id from batch summaryrecipients[].messageIdor search list rows
Returns an empty array when the recipient does not belong to the batch. Set include_content=true to include HTML/text body on applicable events.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns the ordered event timeline for one recipient inside a batch send.
Use this endpoint after Get email tracking (batch summary) when you need the full delivery history (queued, sent, delivered, bounced, opens, clicks) for a single to address.
Authentication
Authorization: Bearer {access_token} with scope transactional_email or all. No Principal header.
Path and query
| Parameter | Location | Description |
|---|---|---|
trackingId | path | Batch trackingId from send response (same as batch summary) |
messageId | path | Per-recipient worker id from recipients[].messageId or search list rows |
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/recipients/a1b2c3d4-e5f6-7890-abcd-ef1234567890?include_content=false' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'Response
JSON array of tracking events (same shape as Get email tracking (single message timeline)).
Returns an empty array when the messageId does not belong to the given batch trackingId.
Troubleshooting fields
Optional fields on timeline rows — same as the single-message timeline:
| Field | Description |
|---|---|
results[] | SMTP delivery attempts |
dsn | Delivery Status Notification payload |
callbackBody | Open/click webhook metadata |
content | Message body when include_content=true |
IDs
| Id | Role |
|---|---|
| trackingId (path) | Batch id from send — scopes the request to one HTTP send |
| messageId (path) | Recipient timeline key — unique per to address in the batch |
Legacy single-recipient sends may still use Get email tracking (single message timeline) with one id for both search and timeline.
Missing or invalid Bearer token
Insufficient role or OAuth scope (transactional_email required)
Message not found for this account