List Alerts

Retrieve alerts that have been triggered. Use this to build dashboards, integrate with ticketing systems, or create custom notification workflows.

When to Use

Dashboard integration: Show recent alerts in monitoring tools
Ticketing sync: Create tickets for triggered alerts
Reporting: Generate alert volume and response metrics
Custom workflows: Build automated response systems

SDK & CLI Examples

from anomalyarmor import Client

client = Client(api_key="aa_live_xxx")

# Get recent unacknowledged alerts
alerts = client.alerts.list(status="triggered", limit=20)

for alert in alerts:
    print(f"{alert.rule_name}: {alert.message}")
    print(f"  Asset: {alert.asset}")
    print(f"  Triggered: {alert.triggered_at}")

# Filter by alert type
schema_alerts = client.alerts.list(event_type="schema_change")

# Filter by date range
from datetime import datetime, timedelta
yesterday = datetime.now() - timedelta(days=1)
alerts = client.alerts.list(since=yesterday)

# List recent alerts
anomalyarmor alerts list

# Filter by status
anomalyarmor alerts list --status triggered

# Filter by event type
anomalyarmor alerts list --type schema_change

# Output as JSON
anomalyarmor alerts list --format json

Parameters

Parameter	Type	Description
`status`	string	Filter by status: `triggered`, `acknowledged`, `resolved`
`event_type`	string	Filter by type: `schema_change`, `freshness_violation`, `discovery_failed`
`asset`	string	Filter by asset qualified name
`since`	datetime	Only alerts after this timestamp
`until`	datetime	Only alerts before this timestamp
`limit`	integer	Max results (default: 100, max: 1000)
`offset`	integer	Skip first N results

Response

{
  "alerts": [
    {
      "id": "alt_abc123",
      "rule_name": "Production Schema Changes",
      "event_type": "schema_change",
      "status": "triggered",
      "message": "Column 'status' removed from orders table",
      "asset": "snowflake.prod.public.orders",
      "details": {
        "change_type": "column_removed",
        "column_name": "status",
        "column_type": "varchar(20)"
      },
      "triggered_at": "2024-01-15T08:30:00Z",
      "acknowledged_at": null,
      "resolved_at": null,
      "destinations": ["slack", "pagerduty"]
    }
  ],
  "total": 45,
  "limit": 100,
  "offset": 0
}

Response Fields

Field	Description
`id`	Unique alert identifier
`rule_name`	Name of the rule that triggered
`event_type`	Type of event that triggered the alert
`status`	`triggered`, `acknowledged`, or `resolved`
`message`	Human-readable alert description
`asset`	Affected asset qualified name
`details`	Event-specific details (varies by type)
`triggered_at`	When the alert fired
`acknowledged_at`	When someone acknowledged it (if applicable)
`resolved_at`	When the alert was resolved (if applicable)
`destinations`	Where the alert was sent

Status Values

Status	Meaning
`triggered`	Alert fired, not yet acknowledged
`acknowledged`	Someone is looking at it
`resolved`	Issue has been addressed

Event Types

Type	Description
`schema_change`	Table or column structure changed
`freshness_violation`	Data older than SLA threshold
`discovery_failed`	Discovery job couldn’t complete
`asset_removed`	Table or view no longer exists

Error Responses

Status	Meaning
`401`	Invalid or missing API key
`400`	Invalid filter parameters
`429`	Rate limit exceeded

API Overview

API Reference

API Guides

SDKs

CLI

Integrations

AI Agents

When to Use

SDK & CLI Examples

Parameters

Response

Response Fields

Status Values

Event Types

Error Responses

​When to Use

​SDK & CLI Examples

​Parameters

​Response

​Response Fields

​Status Values

​Event Types

​Error Responses

When to Use

SDK & CLI Examples

Parameters

Response

Response Fields

Status Values

Event Types

Error Responses