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 & collectors
    3. Dashboards
      1. Dashboards API
      2. Charts API
        1. List all charts GET
        2. Get a single chart GET
        3. Create a chart POST
        4. Update a chart PATCH
        5. Remove a chart DELETE
      3. Dashboard sections API
      4. Dashboard alerts API
      5. Dashboard groups API
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
  7. Alternative to
    1. Lightstep

Get a single chart

Retrieves a single chart by its ID from a specific dashboard.

GET https://telemetry.betterstack.com/api/v2/dashboards/{dashboard_id}/charts/{id}

URL parameters

dashboard_id
required integer

The unique identifier of the dashboard.

id
required integer

The unique identifier of the chart.

Headers

Authorization
required string

Bearer $TOKEN

200

The details of the specified chart.

Response body

{
  "data": {
    "id": "567",
    "type": "chart",
    "attributes": {
      "chart_type": "line_chart",
      "name": "CPU Usage",
      "description": "Average CPU usage over time.",
      "x": 0,
      "y": 0,
      "w": 6,
      "h": 4,
      "settings": {
        "unit": "percent",
        "y_axis_scale": "linear"
      },
      "queries": [
        {
          "id": 890,
          "name": "CPU Query",
          "query_type": "sql_expression",
          "source_variable": "source",
          "sql_query": "SELECT {{time}} as time, avg(cpu) as value FROM metrics GROUP BY time"
        }
      ]
    }
  }
}
404

The specified dashboard or chart was not found.

Example Request

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


Previous article

List all charts

Next article

Create a chart