---
title: "List Drift Alerts"
method: GET
path: "/api/v1/agents/{agent_id}/drift-alerts"
tags: ["drift-alerts"]
---

# List Drift Alerts

`GET /api/v1/agents/{agent_id}/drift-alerts`

## Request

- Base URL: `https://api.badgeia.com`
- URL: `https://api.badgeia.com/api/v1/agents/{agent_id}/drift-alerts`
- Auth: none declared

## Path parameters

- `agent_id` string, uuid, required

## Query parameters

- `limit` integer
- `include_acknowledged` boolean

## Response `200`

Successful Response

- DriftAlertList
  - `agent_id` string, uuid, required
  - `scope` 'owner' | 'public', required
  - `items` union, required
    - DriftAlertRead[]
      - `id` string, uuid, required
      - `agent_id` string, uuid, required
      - `metric` 'score' | 'pass_rate' | 'cost' | 'latency', required
      - `event` string, required
      - `direction` 'up' | 'down', required
      - `bucket_date` string, date, required
      - `window_buckets` integer, required
      - `baseline_mean` number, required
      - `baseline_std` number, required
      - `observed` number, required
      - `z` number, required
      - `delta` number, required
      - `run_ids` string[], required
      - `blueprint_version_id` string, uuid, nullable, required
      - `blueprint_version_number` integer, nullable, required
      - `created_at` string, date-time, required
      - `notified_at` string, date-time, nullable, required
      - `acknowledged_at` string, date-time, nullable, required
    - DriftAlertPublicRead[]
      - `metric` 'score' | 'pass_rate' | 'cost' | 'latency', required
      - `bucket_date` string, date, required
      - `direction` 'up' | 'down', required
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/badgeia/apis/badge.md) · [All operations](https://skmtc.dev/badgeia/apis/badge/llms.txt) · [OpenAPI document](https://skmtc.dev/badgeia/apis/badge/revisions/7e7f7fee8b77?raw)
