---
title: "Return a message's opens and clicks"
method: GET
path: "/v3/activity/tracking/messages/{message_id}"
tags: ["Tracking events"]
---

# Return a message's opens and clicks

`GET /v3/activity/tracking/messages/{message_id}`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/activity/tracking/messages/{message_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nylas/apis/nylas-api/docs/v3/activity/tracking/messages/:message_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns engagement for one message: how many times it was opened, when it was first and last
opened, and how many clicks each link got. Opens and clicks are counted per message, not per
recipient. Covers messages sent in the last 90 days.

## Response `200`

Success. Returns the message's opens and clicks.

- object
  - `request_id` string: The request ID.
  - `data` TrackingMessage: Opens and link clicks for one message.
    - `message_id` string: The ID of the message.
    - `thread_id` string: The Agent Account thread the message belongs to. Empty for a transactional send.
    - `grant_id` string: The Agent Account grant that sent the message. Empty for a transactional send.
    - `from` string: The email address the message was sent from.
    - `sending_domain` string: The domain the message was sent from.
    - `label` string: The `tracking_options.label` you set when you sent the message.
    - `tracking` object: Which kinds of tracking were turned on when the message was sent.
      - `opens` boolean: Whether open tracking was on.
      - `links` boolean: Whether link click tracking was on.
    - `opens` object: Opens of the message. Opens are counted per message, not per recipient.
      - `total` integer: The number of opens, including repeat opens.
      - `first_at` integer, nullable: When the message was first opened, as a Unix timestamp in seconds. `null` if it hasn't been opened.
      - `last_at` integer, nullable: When the message was last opened, as a Unix timestamp in seconds. `null` if it hasn't been opened.
    - `clicks` object: Link clicks in the message.
      - `total` integer: The number of clicks on any link, including repeat clicks.
      - `first_at` integer, nullable: When a link was first clicked, as a Unix timestamp in seconds. `null` if no link has been clicked.
      - `last_at` integer, nullable: When a link was last clicked, as a Unix timestamp in seconds. `null` if no link has been clicked.
      - `links` object[]: Clicks per link, in the order the links appear in the message.
        - `link_index` integer: The position of the link in the message, starting at 0.
        - `url` string: The link.
        - `clicks` integer: The number of clicks on the link.
    - `events` object[]: The 100 most recent opens and clicks, newest first. The totals count every open and click.
      - `id` string: The ID of the event.
      - `event_type` 'opened' | 'link_clicked': Whether the message was opened or a link was clicked.
      - `timestamp` integer: When the open or click happened, as a Unix timestamp in seconds.
      - `is_first` boolean: `true` for the first open, or the first click, recorded for the message.
      - `url` string: For a click, the link that was clicked.
      - `link_index` integer: For a click, the position of the link in the message, starting at 0.
      - `ip` string: The IP address the open or click came from. Can be a comma-separated list when the request passed through proxies.
      - `user_agent` string: The user agent of the client.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden. These endpoints need your application's API key, not a grant access token.
- `404`: Not found. Nylas has no tracking activity for this ID in the last 90 days.

## Changes

- **2026-10-30** `7b9fe7c66c1c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/activity/tracking/messages/:message_id/get.md)

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) - [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nylas/apis/nylas-api/revisions/7782a3e3ab70?raw)