---
title: "Get all dashboards"
method: GET
path: "/api/v1/dashboard"
tags: ["Dashboards"]
---

# Get all dashboards

`GET /api/v1/dashboard`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v1/dashboard`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `dashboards_read`

Get all dashboards.

**Note**: This query will only return custom created or cloned dashboards.
This query will not return preset dashboards.

## Query parameters

- `filter[shared]` boolean
- `filter[deleted]` boolean
- `count` integer
- `start` integer

## Response `200`

OK

- DashboardSummary: Dashboard summary response.
  - `dashboards` DashboardSummaryDefinition[]: List of dashboard definitions.
    - `author_handle` string: Identifier of the dashboard author.
    - `created_at` string, date-time: Creation date of the dashboard.
    - `description` string, nullable: Description of the dashboard.
    - `id` string: Dashboard identifier.
    - `is_read_only` boolean: Whether this dashboard is read-only. If True, only the author and admins can make changes to it. This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/) instead to manage write authorization for individual dashboards.
    - `layout_type` 'ordered' | 'free': Layout type of the dashboard.
    - `modified_at` string, date-time: Modification date of the dashboard.
    - `title` string: Title of the dashboard.
    - `url` string: URL of the dashboard.

## Other responses

- `403`: Authentication Error
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v1-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v1-collection/revisions/ca5871004d26?raw)