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
      3. Dashboard sections API
      4. Dashboard alerts API
      5. 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 ↗
  7. Alternative to
    1. Lightstep

List dashboards in a group

Retrieves a paginated list of dashboards within a specific group.

GET https://telemetry.betterstack.com/api/v2/dashboard-groups/{id}/dashboards

URL parameters

id
required integer

The unique identifier of the dashboard group.

Query parameters

page
integer

Page number for pagination.

per_page
integer

Number of items per page (max 250).

query
string

Search for dashboards by name within the group.

Headers

Authorization
required string

Bearer $TOKEN

200

A paginated list of dashboards in the specified group.

Response body

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

A dashboard group with the specified ID was not found.

Example Request

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


Previous article

Remove a dashboard group

Next article

List all explorations