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

List explorations in a group

Retrieves a paginated list of explorations within a specific group.

This is a convenience endpoint and is equivalent to GET /api/v2/explorations?exploration_group_id=:id.

GET https://telemetry.betterstack.com/api/v2/exploration-groups/{id}/explorations

URL parameters

id
required integer

The unique identifier of the exploration group.

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 within the group.

Headers

Authorization
required string

Bearer $TOKEN

200

A paginated list of explorations in the specified group.

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/exploration-groups/456/explorations?page=1",
    "last": "https://telemetry.betterstack.com/api/v2/exploration-groups/456/explorations?page=1",
    "prev": null,
    "next": null
  }
}
404

An exploration group with the specified ID was not found.

Example Request

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


Previous article

Remove an exploration group

Next article

List alerts in exploration