List all explorations

Retrieves a paginated list of your team's explorations.

This endpoint returns a summary of each exploration. For full details, including chart, query, and variable configurations, use the Get an exploration endpoint.

GET https://telemetry.betterstack.com/api/v2/explorations

Query parameters

page
integer
per_page
integer
query
string

Headers

Authorization
required string
200

Response body

{
  "data": [
    {
      "id": 123,
      "type": "exploration",
      "attributes": {
        "name": "Error Rate Analysis",
        "date_range_from": "now-3h",
        "date_range_to": "now",
        "exploration_group_id": 456,
        "created_at": "2026-02-20T10:00:00Z",
        "updated_at": "2026-02-23T14:30:00Z"
      }
    }
  ],
  "pagination": {
    "first": "https://telemetry.betterstack.com/api/v2/explorations?page=1",
    "last": "https://telemetry.betterstack.com/api/v2/explorations?page=10",
    "prev": null,
    "next": "https://telemetry.betterstack.com/api/v2/explorations?page=2"
  }
}
401

Example requests

List all Search by name
curl --request GET \
     --url "https://telemetry.betterstack.com/api/v2/explorations" \
     --header "Authorization: Bearer $TOKEN"
curl --request GET \
     --url "https://telemetry.betterstack.com/api/v2/explorations?query=my+explore" \
     --header "Authorization: Bearer $TOKEN"