# Return a tracking event

> **GET** `https://api.us.nylas.com/v3/activity/tracking/{event_id}`

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

Returns one open or link click by its ID.

**Authentication:** NYLAS_API_KEY

## Parameters

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `event_id` | string, pattern: `^[0-9a-f]{64}$` | Yes | The ID of the event, as returned in the event's `id` field. |

## Responses

### 200 - Success. Returns the tracking event.

- `request_id` (string) - The request ID.
- `data` (object) - One open or link click on a message.
  - `id` (string) - The ID of the event.
  - `event_type` (string, one of: `opened`, `link_clicked`) - Whether the message was opened or a link in it was clicked.
  - `timestamp` (integer, format: int64) - 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. For a transactional send, this is the message's `Message-ID` header.
  - `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.

### 401 - Unauthorized

- `request_id` (string) - The request ID.
- `error` (object) - The response error object.
  - `type` (string) - The error type.
  - `message` (string) - The error message.
  - `provider_error` (object) - The error from the provider.

### 403 - Forbidden. These endpoints need your application's API key, not a grant access token.

- `request_id` (string) - The request ID.
- `error` (object) - The response error object.
  - `type` (string) - The error type.
  - `message` (string) - The error message.

### 404 - Not found. Nylas has no tracking activity for this ID in the last 90 days.

- `request_id` (string) - The request ID.
- `error` (object) - The response error object.
  - `type` (string) - The error type.
  - `message` (string) - The error message.

## Code samples

### cURL

```bash
curl --request GET \
  --url "https://api.us.nylas.com/v3/activity/tracking/<EVENT_ID>" \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <NYLAS_API_KEY>'
```
