Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    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. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
    3. Dashboards
    4. Explorations
      1. 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
      2. Exploration alerts API
      3. Exploration groups API
    5. Alerts API
    6. Connections API
    7. Query API ↗
    8. Usage 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.

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

Query parameters

page
integer

Page number for pagination.

per_page
integer

Number of items per page (max 250).

Headers

Authorization
required string

Bearer $TOKEN

200

Returns 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:00.000Z",
        "updated_at": "2026-02-23T14:30:00.000Z"
      }
    }
  ],
  "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.

Response attributes

id
string

The ID of the exploration.

type
string

Always exploration.

attributes.name
string

The name of the exploration, generated from its query when it still has the default name.

attributes.date_range_from
string

The start of the exploration's time range, for example now-3h.

attributes.date_range_to
string

The end of the exploration's time range, for example now.

attributes.exploration_group_id
integer or null

The ID of the exploration group, or null when the exploration isn't in a group.

attributes.created_at
string

When the exploration was created, as an ISO 8601 date-time in UTC.

attributes.updated_at
string

When the exploration was last updated, as an ISO 8601 date-time in UTC.

pagination.first
string

The URL of the first page. Read more about pagination.

pagination.last
string

The URL of the last page.

pagination.prev
string or null

The URL of the previous page, or null on the first page.

pagination.next
string or null

The URL of the next page, or null on the last page.

Example request

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


Previous article

List dashboards in a group

Next article

Get a single exploration