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 all exploration groups

Retrieves a paginated list of your team's exploration groups.

GET https://telemetry.betterstack.com/api/v2/exploration-groups

Query parameters

page
1 integer

Page number for pagination.

per_page
50 integer

Number of items per page (max 250).

query
string

Search for exploration groups by name.

Headers

Authorization
required string

Bearer $TOKEN

200

A paginated list of exploration groups.

Response body

{
  "data": [
    {
      "id": 456,
      "type": "exploration_group",
      "attributes": {
        "name": "Production Monitoring",
        "created_at": "2026-02-20T10:00:00Z",
        "updated_at": "2026-02-23T14:30:00Z"
      }
    }
  ],
  "pagination": {
    "first": "https://telemetry.betterstack.com/api/v2/exploration-groups?page=1",
    "last": "https://telemetry.betterstack.com/api/v2/exploration-groups?page=2",
    "prev": null,
    "next": "https://telemetry.betterstack.com/api/v2/exploration-groups?page=2"
  }
}
401

Invalid or missing authentication token.

Example Request

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


Previous article

Remove an exploration

Next article

Get a single exploration group