---
title: "List send events"
method: GET
path: "/v3/activity/send"
tags: ["Send events"]
---

# List send events

`GET /v3/activity/send`

## Request

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

Returns what happened to your messages, one event per recipient: accepted, delivered, bounced,
marked as spam, or rejected. Filter by recipient, message, sender, or event type to find out why
a message didn't reach someone, or to list every hard bounce from a sending domain.

Covers transactional and Agent Account sends. Events are kept for 90 days, and the default window
is the last 7 days. Results are sorted by event time, newest first.

This endpoint is for looking back at events, not for real-time updates. Avoid polling it for new events. To act on each
delivery outcome as it happens, use [webhook notifications](/docs/v3/agent-accounts/monitor-delivery-engagement/#use-webhooks-for-real-time-events).

## Query parameters

- `event_type` string[]
- `bounce_class` 'hard' | 'soft' | 'undetermined'
- `recipient` string
- `recipient_domain` string
- `sending_domain` string
- `from` string
- `grant_id` string
- `message_id` string
- `thread_id` string
- `start` integer
- `end` integer
- `order` 'desc' | 'asc'
- `limit` integer
- `page_token` string

## Response `200`

Success. Returns a page of send events.

- object
  - `request_id` string: The request ID.
  - `data` object[]: The list of objects returned by the request.
    - `id` string: The ID of the event.
    - `event_type` 'accepted' | 'delivered' | 'bounced' | 'complaint' | 'rejected': What happened. `accepted` means Nylas accepted the message for delivery. `delivered` means the recipient's mail server accepted it. `bounced` means it wasn't delivered. `complaint` means the recipient marked it as spam. `rejected` means Nylas didn't send it because of bad content.
    - `bounce_class` 'hard' | 'soft' | 'undetermined': For a bounce, whether it's permanent (`hard`), temporary (`soft`), or unclassified (`undetermined`). Stop sending to addresses that hard-bounce.
    - `timestamp` integer: When the event 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.
    - `recipient` string: The recipient's email address.
    - `recipient_domain` string: The recipient's domain.
    - `subject` string: The message subject.
    - `reason` string: A short summary of why the event happened, such as the bounce subtype and status code, the SMTP response for a delivery, or the feedback type for a complaint. Empty for `accepted`.
    - `detail` Detail: Delivery details reported by the recipient's mail server. Only the fields that apply to the event are included.
      - `smtp_response` string: The SMTP response from the recipient's mail server.
      - `processing_time_ms` integer: How long delivery took, in milliseconds.
      - `reporting_mta` string: The mail server that reported the event.
      - `remote_mta_ip` string: The IP address of the recipient's mail server.
      - `bounce_type` string: The bounce type, such as `Permanent` or `Transient`.
      - `bounce_subtype` string: The bounce subtype, such as `General`, `NoEmail`, `MailboxFull`, or `Suppressed`. `Suppressed` means the address is on a suppression list because of an earlier bounce or complaint.
      - `status` string: The enhanced SMTP status code.
      - `action` string: The delivery action the mail server reported.
      - `diagnostic_code` string: The diagnostic message from the recipient's mail server.
      - `feedback_type` string: For a complaint, the type of feedback the mailbox provider reported, such as `abuse`.
      - `complaint_subtype` string: For a complaint, the complaint subtype, if the provider reported one.
  - `next_cursor` string, nullable: A cursor pointing to the next page of results for the request.

## Other responses

- `400`: Bad request. A query parameter or the request body isn't valid.
- `401`: Unauthorized
- `403`: Forbidden. These endpoints need your application's API key, not a grant access token.

## Changes

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

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/activity/send/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)