---
title: "List Usage Alerts Endpoint"
method: GET
path: "/v1/usage-alerts"
tags: ["Usage Alerts"]
---

# List Usage Alerts Endpoint

`GET /v1/usage-alerts`

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- UsageAlertResponse[]
  - `id` string, uuid, required
  - `name` string, required
  - `metronome_alert_id` string, required
  - `notification_channels` NotificationChannel[], required
    - `type` 'email' | 'slack' | 'webhook', required
    - `target` string, required — Email address, Slack channel id, or https webhook URL
  - `is_enabled` boolean, required
  - `threshold` number, nullable
  - `alert_type` string, nullable
  - `status` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-01** `84e25a31d733` — 1 warning
  - added the new `webhook` enum value to the `items/notification_channels/items/type` response property for the response status `200`

[Change history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/usage-alerts/get.md)

---

[API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.dev/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/dc799889b9fe/schema)