---
title: "List Dashboards"
method: GET
path: "/v1/dashboards"
tags: ["Dashboards"]
---

# List Dashboards

`GET /v1/dashboards`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/dashboards`
- Auth: none declared
- TypeScript: <https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/docs/v1/dashboards/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists dashboard overviews in your Confident AI project — metadata and widget counts only. Widget configurations are returned by the dashboard detail endpoint, and computed widget data by the query endpoints.

## Response `200`

The dashboard overviews in your project.

- DashboardListResponse
  - `success` boolean, required: Indicates if the request was successful.
  - `data` object, required: The dashboards in your project.
    - `dashboards` DashboardOverview[], required: The list of dashboard overviews.
      - `id` string: The unique id of the dashboard.
      - `name` string: The dashboard's name.
      - `description` string, nullable: An optional description of the dashboard.
      - `private` boolean: Whether the dashboard is private to its creator.
      - `projectId` string: The id of the project that owns the dashboard.
      - `userId` string, nullable: The id of the dashboard creator, when available.
      - `widgetCount` integer: The number of widgets on the dashboard.
      - `createdAt` string, date-time: When the dashboard was created.
      - `updatedAt` string, date-time: When the dashboard was last updated.
  - `deprecated` boolean, required: Indicates if this endpoint is deprecated.

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-06-30** `c5abbfd34161`: 3 info
  - added the optional property `data/dashboards/items/projectId` to the response with the `200` status
  - added the optional property `data/dashboards/items/userId` to the response with the `200` status
  - added the optional property `data/dashboards/items/widgetCount` to the response with the `200` status
- **2026-06-30** `8b6c262fba71`: 1 info
  - endpoint added
- **2026-06-29** `a3c9e9461f9c`: 1 breaking
  - api path removed without deprecation
- **2026-06-29** `77c4156f18d2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/dashboards/get.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)