Receive Emails: Send & trust

Get Tracking

Returns opens and clicks of the emails sent by this mailbox. Read only.

POSThttps://g.sendcorex.com/v1command: get_tracking
i

Only messages sent with tracking appear in the result.

i

Opens from bots and proxies are not counted.

!

Opens are an estimate: some email apps load images automatically or block them.

i

The status of each message is kept for 180 days.

Arguments

  • idsstring[]required

    1 to 200 message_uid of sent messages. They come from Sent, from the send_email / reply response or from list_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_clicks

    What was tracked when the email was sent.

  • opens / clicks

    Totals across all recipients.

  • first_open_at / last_open_at / last_click_at

    First and last activity (UTC), or null.

  • unsubscribe / unsubscribes

    Whether the email had an unsubscribe link, and how many recipients unsubscribed through it.

  • recipients

    Per recipient: email, opens, clicks, last_at, unsubscribed and urls (each link clicked, newest first, with url, at of the last click and clicks; [] 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.

  • 401TOKEN_EXPIRED

    The access token has expired. Call Refresh Token and repeat the request.

  • 401INVALID_TOKEN

    The token is malformed, unknown or revoked.

  • 429RATE_LIMITED

    More than 15 requests/s or 15 in flight for the same IP + mailbox. Wait the number of seconds in Retry-After.

  • CMDINVALID_ARGS

    A required argument is missing or invalid.

  • CMDINTERNAL

    Server error. The detail is only written to the server log.