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

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.

The Explorations API is only available for the Telemetry product and can only be accessed via the telemetry.betterstack.com hostname.

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

Query parameters

page
1 integer

Page number for pagination.

per_page
50 integer

Number of items per page (max 250).

query
string

Search for explorations by name.

exploration_group_id
integer

Filter explorations by the ID of their exploration group.

Headers

Authorization
required string

Bearer $TOKEN

200

A paginated list of explorations.

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

Invalid or missing authentication token.

Example Request

cURL
curl --request GET \
     --url "https://telemetry.betterstack.com/api/v2/explorations?per_page=5" \
     --header "Authorization: Bearer $TOKEN"


Previous article

List dashboard templates

Next article

Get a single exploration