Get a single exploration

Retrieves a single exploration by its ID, including the full chart, query, and variable configurations.

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

URL parameters

id
required integer

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",
      "chart": {
        "chart_type": "line_chart",
        "name": "Error Rate by Service",
        "description": "Shows error rates across all services",
        "settings": {
          "unit": "number",
          "decimal_places": 2,
          "legend": "bottom",
          "stacking": "dont_stack",
          "x_axis_type": "time"
        }
      },
      "queries": [
        {
          "id": 1,
          "name": "Main Query",
          "query_type": "sql_expression",
          "sql_query": "SELECT {{time}} AS time, count(*) AS value FROM {{source}} WHERE time BETWEEN {{start_time}} AND {{end_time}} GROUP BY time",
          "source_variable": "source"
        }
      ],
      "variables": [
        {
          "name": "source",
          "variable_type": "source",
          "default_values": [
            "123"
          ]
        },
        {
          "name": "log_level",
          "variable_type": "select_value",
          "values": [
            "error",
            "warning",
            "info"
          ],
          "default_values": [
            "error"
          ]
        }
      ]
    }
  }
}
401
404

Response body

{
  "errors": "Resource with provided ID was not found"
}

Example request

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