Receive Emails: Send & trust
Get Tracking
Returns opens and clicks of the emails sent by this mailbox. Read only.
https://g.sendcorex.com/v1command: get_trackingOnly messages sent with tracking appear in the result.
Opens from bots and proxies are not counted.
Opens are an estimate: some email apps load images automatically or block them.
The status of each message is kept for 180 days.
Arguments
idsstring[]required1 to 200
message_uidof sent messages. They come from Sent, from thesend_email/replyresponse or fromlist_messages.
Quick start
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "get_tracking",
args: {
ids: [
"Vj0xQUJDMTIz",
"Vj0xQUJDMTI0"
]
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Response
{
"type": "SUCCESS",
"results": [
{
"command": "get_tracking",
"id": "0",
"type": "SUCCESS",
"data": {
"tracking": {
"Vj0xQUJDMTIz": {
"track_opens": true,
"track_clicks": true,
"opens": 3,
"clicks": 1,
"first_open_at": "2026-11-21T07:10:00Z",
"last_open_at": "2026-11-21T09:42:00Z",
"last_click_at": "2026-11-21T09:43:00Z",
"unsubscribe": true,
"unsubscribes": 0,
"recipients": [
{
"email": "ana@empresa.com",
"opens": 3,
"clicks": 1,
"last_at": "2026-11-21T09:43:00Z",
"unsubscribed": false,
"urls": [
{
"url": "https://acme.com/pricing",
"at": "2026-11-21T09:43:00Z",
"clicks": 1
}
]
}
]
}
}
}
}
]
}Response fields
tracking.<message_uid>One entry per message sent with tracking. A message sent without tracking is not listed.
track_opens / track_clicksWhat was tracked when the email was sent.
opens / clicksTotals across all recipients.
first_open_at / last_open_at / last_click_atFirst and last activity (UTC), or
null.unsubscribe / unsubscribesWhether the email had an unsubscribe link, and how many recipients unsubscribed through it.
recipientsPer recipient:
email,opens,clicks,last_at,unsubscribedandurls(each link clicked, newest first, withurl,atof the last click andclicks;[]when the person didn’t click).
Tracking
How opens and clicks are measured.
Opens
Each email carries an invisible pixel. When the recipient’s app loads it, an open is counted. Some apps load images on their own or block them, so the number is an estimate.
Clicks
Each link goes through a redirect that counts the click and takes the recipient straight to the original address.
Privacy
Recipients who refused tracking on the preferences page are never tracked. To turn tracking off for one email, send track_opens: false and track_clicks: false.
Errors
HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.
- 401
TOKEN_EXPIREDThe access token has expired. Call Refresh Token and repeat the request.
- 401
INVALID_TOKENThe token is malformed, unknown or revoked.
- 429
RATE_LIMITEDMore than 15 requests/s or 15 in flight for the same IP + mailbox. Wait the number of seconds in Retry-After.
- CMD
INVALID_ARGSA required argument is missing or invalid.
- CMD
INTERNALServer error. The detail is only written to the server log.