Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    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. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
    3. Dashboards
      1. Dashboards API
      2. Charts API
      3. Chart comments API
      4. Dashboard sections API
      5. Dashboard alerts API
      6. Dashboard groups API
        1. List all dashboard groups GET
        2. Get a single dashboard group GET
        3. Create a dashboard group POST
        4. Update a dashboard group PATCH
        5. Remove a dashboard group DELETE
        6. List dashboards in a group GET
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
    8. Usage API ↗
  7. Alternative to
    1. Lightstep

List all dashboard groups

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

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

Query parameters

page
integer

Page number for pagination.

per_page
integer

Number of items per page (max 250).

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of dashboard groups.

Response body

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

Invalid or missing authentication token.

Response attributes

id
string

The ID of the dashboard group.

type
string

Always dashboard_group.

attributes.name
string

The name of the dashboard group.

attributes.created_at
string

When the dashboard group was created, as an ISO 8601 date-time in UTC.

attributes.updated_at
string

When the dashboard group was last updated, as an ISO 8601 date-time in UTC.

pagination.first
string

URL of the first page. Read more about pagination.

pagination.last
string

URL of the last page.

pagination.prev
string or null

URL of the previous page, or null on the first page.

pagination.next
string or null

URL of the next page, or null on the last page.

Example request

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


Previous article

Remove a dashboard alert

Next article

Get a single dashboard group