Get email tracking (batch summary)

Return the latest status per recipient for one HTTP send batch.

Pass the trackingId from Send a transactional email. Each recipients[] item includes per-recipient messageId — use it with Get email tracking (recipient timeline). For the full event history of a single-recipient send, Get email tracking (single message timeline) is usually enough.

Optional dateStart / dateEnd bound the search window. A 200 returns trackingId plus recipients[].

Common failures: 404 unknown batch; 401/403 auth issues.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Returns the latest delivery status per recipient for one HTTP send batch.

Use the trackingId from Send a transactional email. For multi-recipient sends, this is the batch id — not the per-recipient timeline key.

Authentication

Authorization: Bearer {access_token} with scope transactional_email or all. No Principal header.

Path and query

ParameterLocationDescription
trackingIdpathBatch trackingId from send response
dateStartqueryOptional ISO-8601 UTC start of range
dateEndqueryOptional ISO-8601 UTC end of range

Example — cURL

curl -X GET 'https://connect.routee.net/email/tracking/batch/51b1738c-5fc5-4aa2-85a4-3b063c486cd7?dateStart=2026-07-01T00:00:00Z&dateEnd=2026-07-10T23:59:59Z' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response

FieldDescription
trackingIdEcho of the batch id
recipients[]One summary row per recipient (latest event)

Each recipients[] item includes:

FieldDescription
messageIdPer-recipient id — pass to Get email tracking (recipient timeline)
recipient, from, subjectEnvelope summary
status, deliveryStatus, eventLatest human-readable and MTA status
channelAPI, SMTP, or MARKETING
dateLatest event timestamp (UTC)
openedCount, clickCountEngagement counters

Next step

For the full queued → sent → delivered timeline of one recipient:

curl -X GET 'https://connect.routee.net/email/tracking/single/BATCH_TRACKING_ID/recipients/RECIPIENT_MESSAGE_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

See Email API for the identifier glossary.

Path Params
string
required

Primary customer tracking id from the send response or search trackingId field. Internal messageId also accepted when values differ.

Query Params
date-time

Start of date range (ISO-8601).

date-time

End of date range (ISO-8601).

Responses

401

Unauthorized — missing, invalid, or expired Bearer token. Obtain a new token from Authentication.

403

Access denied — token lacks transactional_email (or equivalent) permission/scope.

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json