---
title: "List alert rules"
method: GET
path: "/v3/alerts/send"
tags: ["Send alerts"]
---

# List alert rules

`GET /v3/alerts/send`

## Request

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

Returns every alert rule in your application, oldest first. An application can have up to 20 rules.

## Response `200`

Success. Returns the alert rules.

- object
  - `request_id` string: The request ID.
  - `data` AlertRule[]
    - `id` string, uuid: The ID of the alert rule.
    - `application_id` string: The ID of your Nylas application.
    - `metric` 'bounce_rate' | 'complaint_rate' | 'delivery_rate': The rate the rule watches. `bounce_rate` is hard bounces as a percentage of sent messages, `complaint_rate` is complaints as a percentage of delivered messages, and `delivery_rate` is delivered messages as a percentage of sent messages.
    - `direction` 'above' | 'below': Whether the rule fires when the rate goes above or below the threshold. Set by the metric: `above` for `bounce_rate` and `complaint_rate`, `below` for `delivery_rate`.
    - `threshold` number: The threshold, as a percentage.
    - `window_hours` integer: How many hours of sending the rate covers.
    - `min_volume` integer: The minimum number of messages a sending domain must send in the window before the rule can fire.
    - `created_at` integer: When the rule was created, as a Unix timestamp in seconds.
    - `updated_at` integer: When the rule was last updated, as a Unix timestamp in seconds.

## Other responses

- `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/alerts/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)