List all alerts in an exploration

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

GET https://telemetry.betterstack.com/api/v2/explorations/{exploration_id}/alerts

URL parameters

exploration_id
required integer

Headers

Authorization
required string
200

Response body

{
  "data": [
    {
      "id": "12345",
      "type": "alert",
      "attributes": {
        "exploration_id": 789,
        "name": "High Error Rate",
        "alert_type": "threshold",
        "query_period": 600,
        "confirmation_period": 120,
        "recovery_period": 60,
        "aggregation_interval": 300,
        "series_names": [],
        "series_names_except": [],
        "source_mode": "source_variable",
        "source_platforms": [],
        "source_variable": null,
        "incident_cause": "Value dropped below threshold",
        "incident_name": null,
        "incident_per_series": false,
        "additional_conditions": [],
        "variable_values": [],
        "created_at": "2026-03-25T10:00:00.000Z",
        "updated_at": "2026-03-25T10:00:00.000Z",
        "operator": "lower_than",
        "value": 50.0,
        "string_value": null,
        "on_missing_data": "dont_fire",
        "check_period": 300,
        "call": false,
        "sms": false,
        "email": true,
        "push": false,
        "critical_alert": false,
        "paused": false,
        "paused_reason": null,
        "escalation_target": "current_team",
        "metadata": null
      }
    },
    {
      "id": "12346",
      "type": "alert",
      "attributes": {
        "exploration_id": 789,
        "name": "Anomaly Detection",
        "alert_type": "anomaly_rrcf",
        "query_period": 60,
        "confirmation_period": 60,
        "recovery_period": 0,
        "aggregation_interval": 60,
        "series_names": [],
        "series_names_except": [],
        "source_mode": "source_variable",
        "source_platforms": [],
        "source_variable": null,
        "incident_cause": null,
        "incident_name": null,
        "incident_per_series": false,
        "additional_conditions": [],
        "variable_values": [],
        "created_at": "2026-03-25T10:00:00.000Z",
        "updated_at": "2026-03-25T10:00:00.000Z",
        "anomaly_sensitivity": 5.0,
        "anomaly_trigger": "any",
        "anomaly_training_range_days": 7,
        "call": false,
        "sms": false,
        "email": true,
        "push": false,
        "critical_alert": false,
        "paused": false,
        "paused_reason": null,
        "escalation_target": "current_team",
        "metadata": null
      }
    }
  ]
}
404

Response attributes

id
string
type
string
attributes.dashboard_id
integer
attributes.chart_id
integer
attributes.exploration_id
integer
attributes.name
string
attributes.alert_type
string
attributes.query_period
integer or null
attributes.confirmation_period
integer
attributes.recovery_period
integer or null
attributes.aggregation_interval
integer or null
attributes.series_names
array
attributes.series_names_except
array
attributes.source_mode
string
attributes.source_platforms
array
attributes.source_variable
string or null
attributes.incident_cause
string or null
attributes.incident_name
string or null
attributes.incident_per_series
boolean
attributes.additional_conditions
array
attributes.additional_conditions[].alert_type
string
attributes.additional_conditions[].operator
string
attributes.additional_conditions[].value
number or null
attributes.additional_conditions[].string_value
string or null
attributes.additional_conditions[].series_names
array
attributes.additional_conditions[].series_names_except
array
attributes.variable_values
array
attributes.variable_values[].name
string
attributes.variable_values[].values
array
attributes.variable_values[].selected_label
string
attributes.created_at
string
attributes.updated_at
string
attributes.operator
string
attributes.value
number or null
attributes.string_value
string or null
attributes.on_missing_data
string
attributes.anomaly_sensitivity
number
attributes.anomaly_trigger
string
attributes.anomaly_training_range_days
integer
attributes.check_period
integer
attributes.call
boolean
attributes.sms
boolean
attributes.email
boolean
attributes.push
boolean
attributes.critical_alert
boolean
attributes.paused
boolean
attributes.paused_reason
string or null
attributes.escalation_target
string or object
attributes.escalation_target.policy_id
integer
attributes.escalation_target.policy_name
string
attributes.escalation_target.team_id
integer
attributes.escalation_target.team_name
string
attributes.metadata
object or null

Example request

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