Get a single alert

Retrieves a single alert by its ID, scoped to a specific exploration.

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

URL parameters

exploration_id
required integer
id
required integer

Headers

Authorization
required string
200

Response body

{
  "data": {
    "id": 789,
    "type": "alert",
    "attributes": {
      "name": "High Error Rate Alert",
      "alert_type": "threshold",
      "operator": "higher_than",
      "value": 100.0,
      "query_period": 300,
      "confirmation_period": 0,
      "recovery_period": 300,
      "aggregation_interval": 60,
      "series_names": [
        "error"
      ],
      "source_variable": "source:logs_table",
      "source_mode": "source_variable",
      "escalation_target": {
        "policy_id": 123
      },
      "paused": false,
      "incident_cause": "Error rate exceeded threshold",
      "metadata": {
        "environment": "production",
        "runbook": "https://wiki.example.com/runbooks/error-rate"
      },
      "created_at": "2026-02-20T10:00:00Z",
      "updated_at": "2026-02-23T14:30:00Z"
    }
  }
}
404

Example Request

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