---
title: "Get Alerts"
method: GET
path: "/v1/alerts"
tags: ["Alerts"]
---

# Get Alerts

`GET /v1/alerts`

Get all alerts for the organization, optionally filtered by source_scope

## Query parameters

- `source_scope` 'all' | 'observability' | 'simulation' — Allowed data source scope for when an alert fires: all, observability only, or simulation only.

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- AlertResponse[]
  - `id` string, required — Unique identifier for the alert
  - `name` string, required — Name of the alert
  - `description` string, nullable — Description of the alert
  - `is_enabled` boolean, required — Whether the alert is enabled
  - `organization_id` string, required — Organization ID
  - `entity_type` 'standard_metric' | 'custom_goal' | 'custom_metric' | 'metadata_field' | 'system_failure', required — Enum representing the entity types for alerts.
  - `entity_field` string, required — The specific field/metric being monitored
  - `operator` 'equals' | 'not_equals' | 'greater_than' | 'less_than' | 'greater_than_or_equal' | 'less_than_or_equal' | 'contains' | 'not_contains', required — Enum representing the comparison operators for alerts.
  - `comparison_value` string, required — Value to compare against
  - `notification_channels` unknown[], required — Notification channels configuration
    - unknown
  - `last_triggered_at` string, date-time, nullable — When the alert was last triggered
  - `trigger_count` integer, required — Number of times triggered
  - `created_by` string, nullable — User who created the alert
  - `applies_to_all_agents` boolean, required — Whether the alert applies to all agents
  - `agents` integer[], nullable — Associated agent IDs
  - `simulation_id` integer, nullable — Optional experiments.id (simulation) this alert is scoped to
  - `evaluation_scope` string, nullable — How this alert is evaluated. Only 'per_simulation_run' is supported.
  - `aggregation` string, nullable — Aggregation mode used to compute the per-run metric value from test results within the run.
  - `created_at` string, date-time, required — When the alert was created
  - `updated_at` string, date-time, nullable — When the alert was last updated
  - `updated_by` string, nullable — User who last updated the alert
  - `threshold_time_interval` integer, nullable, required — For observability source_scope: time window in seconds. For simulation source_scope: K = number of recent completed runs.
  - `min_events` integer, nullable, required — The minimum number of events for the alert. NULL for simulation alerts.
  - `min_events_type` string — Whether min_events is an absolute count or a percentage
  - `in_alert` boolean, required — Whether the alert is in alert
  - `source_scope` string — Which data source fires this alert: 'all', 'observability', or 'simulation'
  - `simulation_name` string, nullable — Name of the simulation (experiment) this alert is scoped to, if any

## Other responses

- `422` — Validation Error

---

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