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 API
    3. Source groups API
    4. Metrics API
    5. Dashboards API
    6. Explorations API
    7. Exploration groups API
    8. Alerts API
      1. List alerts in exploration GET
      2. Get a single alert GET
      3. Create an alert POST
      4. Update an alert PATCH
      5. Remove an alert DELETE
    9. Connections API
    10. Collectors API
    11. Query API ↗
  7. Alternative to
    1. Lightstep

List alerts in 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

The unique identifier of the exploration.

Headers

Authorization
required string

Bearer $TOKEN

200

A list of alerts for the exploration.

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,
        "escalation_target": {
          "policy_id": 123
        },
        "paused": false,
        "created_at": "2026-02-20T10:00:00Z",
        "updated_at": "2026-02-23T14:30:00Z"
      }
    }
  ]
}
404

An exploration with the specified ID was not found.

Example Request

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


Previous article

List explorations in a group

Next article

Get a single alert