---
title: "List Dashboards"
method: GET
path: "/api/v3/meta/bases/{baseId}/dashboards"
tags: ["Dashboards"]
---

# List Dashboards

`GET /api/v3/meta/bases/{baseId}/dashboards`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/bases/{baseId}/dashboards`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/bases/:baseId/dashboards/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of dashboards in the specified base.

**Note**: Dashboard APIs are available on cloud-hosted **Enterprise** plans, and on licensed self-hosted deployments (**Business** plan and above).

## Path parameters

- `baseId` string, required

## Response `200`

List of dashboards retrieved.

- DashboardList
  - `list` DashboardListItem[], required
    - `id` string, required: Unique identifier for the dashboard.
    - `title` string, required: Title of the dashboard.
    - `description` string, nullable: Description of the dashboard.
    - `base_id` string, required: Unique identifier for the base.
    - `workspace_id` string, required: Unique identifier for the workspace.
    - `created_at` string, date-time, required: Timestamp when the dashboard was created.
    - `updated_at` string, date-time, required: Timestamp when the dashboard was last updated.
    - `created_by` string: User ID of the dashboard creator.

## Other responses

- `404`: Base not found.
- `500`: Server error.

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)