Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
    3. Dashboards
      1. Dashboards API
      2. Charts API
      3. Dashboard sections API
      4. Dashboard alerts API
        1. List dashboard alerts GET
        2. Get a single alert GET
        3. Create an alert POST
        4. Update an alert PATCH
        5. Remove an alert DELETE
      5. Dashboard groups API
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
  7. Alternative to
    1. Lightstep

List all alerts in a dashboard

Retrieves all alerts associated with a specific dashboard chart. This endpoint is not paginated.

GET https://telemetry.betterstack.com/api/v2/dashboards/{dashboard_id}/charts/{chart_id}/alerts

URL parameters

dashboard_id
required integer

The unique identifier of the dashboard.

chart_id
required integer

The unique identifier of the chart.

Headers

Authorization
required string

Bearer $TOKEN

200

A list of alerts for the dashboard chart.

Response body


  

    

  Threshold alert


  Anomaly alert



    
    

  

  

  

  
{
  "data": [
    {
      "id": "12345",
      "type": "alert",
      "attributes": {
        "dashboard_id": 123,
        "chart_id": 456,
        "name": "High Error Rate",
        "alert_type": "threshold",
        "operator": "higher_than",
        "value": 100.0,
        "string_value": null,
        "check_period": 300,
        "query_period": 600,
        "confirmation_period": 120,
        "recovery_period": 60,
        "aggregation_interval": 300,
        "series_names": [],
        "source_variable": null,
        "source_mode": "source_variable",
        "source_platforms": [],
        "incident_cause": "Error rate exceeded {{value}}",
        "incident_per_series": false,
        "call": true,
        "sms": false,
        "email": true,
        "push": true,
        "critical_alert": false,
        "paused": false,
        "paused_reason": null,
        "escalation_target": "current_team",
        "metadata": {
          "runbook": "https://wiki.example.com/runbook",
          "env": "production"
        },
        "created_at": "2026-03-25T10:00:00.000Z",
        "updated_at": "2026-03-25T10:00:00.000Z"
      }
    }
  ]
}








  

  
{
  "data": [
    {
      "id": "12346",
      "type": "alert",
      "attributes": {
        "dashboard_id": 123,
        "chart_id": 456,
        "name": "Anomaly Detection",
        "alert_type": "anomaly_rrcf",
        "anomaly_sensitivity": 75.0,
        "anomaly_trigger": "any",
        "query_period": 60,
        "confirmation_period": 60,
        "recovery_period": 0,
        "aggregation_interval": 60,
        "series_names": [],
        "source_variable": null,
        "source_mode": "source_variable",
        "source_platforms": [],
        "incident_cause": null,
        "incident_per_series": false,
        "call": false,
        "sms": false,
        "email": true,
        "push": false,
        "critical_alert": false,
        "paused": false,
        "paused_reason": null,
        "escalation_target": "current_team",
        "metadata": {},
        "created_at": "2026-03-25T10:00:00.000Z",
        "updated_at": "2026-03-25T10:00:00.000Z"
      }
    }
  ]
}
404

A dashboard or chart with the specified ID was not found.

Alert response shape

The attributes in the alert response vary based on the alert_type.

Threshold response Relative response Anomaly response 
{
  "attributes": {
    "alert_type": "threshold",
    "operator": "higher_than",
    "value": 100,
    "string_value": null,
    "check_period": 300
  }
}
{
  "attributes": {
    "alert_type": "relative",
    "operator": "increases_by",
    "value": 50,
    "check_period": 300
  }
}
{
  "attributes": {
    "alert_type": "anomaly_rrcf",
    "anomaly_sensitivity": 75.0,
    "anomaly_trigger": "any"
  }
}

For threshold and relative alerts, the fields anomaly_sensitivity and anomaly_trigger are omitted. For anomaly_rrcf alerts, the fields operator, value, string_value, and check_period are omitted.

Example request

cURL
curl --request GET \
     --url "https://telemetry.betterstack.com/api/v2/dashboards/123/charts/456/alerts" \
     --header "Authorization: Bearer $TOKEN"


Previous article

Remove a dashboard section

Next article

Get a single dashboard alert