---
title: "Return an alert rule"
method: GET
path: "/v3/alerts/send/{rule_id}"
tags: ["Send alerts"]
---

# Return an alert rule

`GET /v3/alerts/send/{rule_id}`

## Request

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

Returns the specified alert rule.

## Response `200`

Success. Returns the alert rule.

- object
  - `request_id` string: The request ID.
  - `data` AlertRule: A rule that sends an `alert.triggered` webhook when a sending domain's rate crosses a threshold.
    - `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.
- `404`: Not found. Your application has no alert rule with this ID.

## Changes

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

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