---
title: "Return a tracking event"
method: GET
path: "/v3/activity/tracking/{event_id}"
tags: ["Tracking events"]
---

# Return a tracking event

`GET /v3/activity/tracking/{event_id}`

## Request

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

Returns one open or link click by its ID.

## Response `200`

Success. Returns the tracking event.

- object
  - `request_id` string: The request ID.
  - `data` TrackingEvent: One open or link click on a message.
    - `id` string: The ID of the event.
    - `event_type` 'opened' | 'link_clicked': Whether the message was opened or a link in it was clicked.
    - `timestamp` integer: When the open or click happened, as a Unix timestamp in seconds.
    - `application_id` string: The ID of your Nylas application.
    - `grant_id` string: The Agent Account grant that sent the message. Empty for a transactional send.
    - `message_id` string: The ID of the message.
    - `thread_id` string: The Agent Account thread the message belongs to. 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.
    - `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 that opened the message or clicked the link.

## 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/:event_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)