# List alert rules

> **GET** `https://api.us.nylas.com/v3/alerts/send`

Source: https://developer.nylas.com/docs/reference/api/send-alerts/list-send-alert-rules/

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

**Authentication:** NYLAS_API_KEY

## Responses

### 200 - Success. Returns the alert rules.

- `request_id` (string) - The request ID.
- `data` (array)
  - `id` (string, format: uuid) - The ID of the alert rule.
  - `application_id` (string) - The ID of your Nylas application.
  - `metric` (string, one of: `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` (string, one of: `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, format: int64) - When the rule was created, as a Unix timestamp in seconds.
  - `updated_at` (integer, format: int64) - When the rule was last updated, as a Unix timestamp in seconds.

### 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.

## Code samples

### cURL

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