Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. time series
  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
      1. List all dashboards GET
      2. Get a single dashboard GET
      3. Export a dashboard GET
      4. Import a dashboard POST
      5. Remove a dashboard DELETE
      6. List templates GET
    6. Connections API
    7. Query API ↗
  7. Alternative to
    1. Lightstep

List all dashboards

Returns a paginated list of your team's dashboards.

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

Query parameters

page
1 integer

Page number for pagination.

per_page
50 integer

Number of items per page (max 250).

Headers

Authorization
required string

Bearer $TOKEN

200

A paginated list of dashboards.

Response body

{
  "data": [
    {
      "id": "1234",
      "type": "dashboard",
      "attributes": {
        "team_id": 123456,
        "team_name": "example-team",
        "name": "Sample Dashboard",
        "created_at": "2025-01-20T15:00:00.000Z",
        "updated_at": "2025-01-20T15:00:00.000Z"
      }
    }
  ],
  "pagination": {
    "first": "https://telemetry.betterstack.com/api/v2/dashboards?page=1&per_page=2",
    "last": "https://telemetry.betterstack.com/api/v2/dashboards?page=16&per_page=2",
    "prev": null,
    "next": "https://telemetry.betterstack.com/api/v2/dashboards?page=2&per_page=2"
  }
}
401

Invalid or missing authentication token.

422

Validation failed due to invalid parameters.

Response body

{
  "errors": "Validation failed",
  "invalid_attributes": [
    "page",
    "per_page"
  ]
}

Example cURL

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


Previous article

Remove a metric

Next article

Get a single dashboard