# Tracking events

Source: https://developer.nylas.com/docs/reference/api/tracking-events/

The Tracking events endpoints show how recipients engage with your [Transactional send](/docs/v3/getting-started/transactional-send/) and [Agent Account](/docs/v3/agent-accounts/) messages: every open and link click on messages sent with [message tracking](/docs/v3/email/message-tracking/) turned on.

Use them to:

- See when a message was opened and which links were clicked.
- Compare open and click rates across date ranges, sending domains, and Agent Accounts.
- Measure how a campaign performed by filtering on its tracking label.

**For real-time events, use webhooks.** These endpoints are for reviewing patterns and trends over time, and for checking engagement on individual messages after they're sent. They aren't for following each message as it happens. Avoid polling them for new events. The `opened` and `link_clicked` events are the same ones that the [`message.opened`](/docs/reference/notifications/message-tracking/message-opened/) and [`message.link_clicked`](/docs/reference/notifications/message-tracking/message-link_clicked/) notifications report. Subscribe to those to act on each open or click. See [Use webhooks for real-time events](/docs/v3/agent-accounts/monitor-delivery-engagement/#use-webhooks-for-real-time-events).

Opens are a signal, not proof that someone read the message: some mail clients and privacy features load images automatically. Use open rates to follow trends. Events are kept for 90 days, and metrics cover up to a year.

For examples, see [Monitor delivery and engagement](/docs/v3/agent-accounts/monitor-delivery-engagement/).


## Endpoints

- **GET** `/v3/activity/tracking` - [List tracking events](https://developer.nylas.com/docs/reference/api/tracking-events/list-tracking-events/)
- **GET** `/v3/activity/tracking/{event_id}` - [Return a tracking event](https://developer.nylas.com/docs/reference/api/tracking-events/get-tracking-event/)
- **GET** `/v3/activity/tracking/messages/{message_id}` - [Return a message's opens and clicks](https://developer.nylas.com/docs/reference/api/tracking-events/get-message-tracking-events/)
- **GET** `/v3/metrics/tracking/summary` - [Return an engagement summary](https://developer.nylas.com/docs/reference/api/tracking-events/get-tracking-summary/)
- **GET** `/v3/metrics/tracking/timeseries` - [Return engagement over time](https://developer.nylas.com/docs/reference/api/tracking-events/get-tracking-timeseries/)
- **GET** `/v3/metrics/tracking` - [Return engagement by domain or sender](https://developer.nylas.com/docs/reference/api/tracking-events/get-tracking-breakdown/)