---
title: "List shared dashboards for a dashboard"
method: GET
path: "/api/v2/dashboard/{dashboard_id}/shared"
tags: ["Dashboard Sharing"]
---

# List shared dashboards for a dashboard

`GET /api/v2/dashboard/{dashboard_id}/shared`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/dashboard/{dashboard_id}/shared`
- 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`

Retrieve shared dashboards associated with the specified dashboard.

## Path parameters

- `dashboard_id` string, required

## Response `200`

OK

- ListSharedDashboardsResponse: Response containing shared dashboards for a dashboard.
  - `data` SharedDashboardResponse[], required: Shared dashboards for the dashboard.
    - `attributes` SharedDashboardResponseAttributes, required: Attributes of a shared dashboard response.
      - `created_at` string, date-time, required: Time when the shared dashboard was created.
      - `embeddable_domains` string[], required: Domains where embed-type shared dashboards can be embedded.
      - `expiration` string, date-time, nullable, required: Time when the shared dashboard expires.
      - `global_time` SharedDashboardGlobalTime, nullable, required: Default time range configuration for the shared dashboard.
      - `global_time_selectable` boolean, required: Whether viewers can select a different global time setting.
      - `invitees` SharedDashboardInvitee[], required: Invitees for invite-only shared dashboards.
        - `access_expiration` string, date-time, nullable, required: Time when the invitee's access expires.
        - `created_at` string, date-time, required: Time when the invitee was added.
        - `email` string, required: Email address of the invitee.
      - `last_accessed` string, date-time, nullable, required: Time when the shared dashboard was last accessed.
      - `selectable_template_vars` SharedDashboardSelectableTemplateVariable[], required: Template variables that viewers can modify.
        - `allow_any_value` boolean, required: Whether viewers can see all tag values for the template variable and specify any value.
        - `default_values` string[], required: Default selected values for the variable.
        - `name` string, required: Name of the template variable.
        - `prefix` string, required: Tag prefix for the variable.
        - `type` string, required: Type of the template variable.
        - `visible_tags` string[], required: Restricts which tag values are visible to the viewer.
      - `share_type` 'open' | 'invite' | 'embed' | 'secure-embed', required: Type of dashboard sharing.
      - `sharer_disabled` boolean, required: Whether the user who shared the dashboard is disabled.
      - `status` 'active' | 'paused', required: Status of the shared dashboard.
      - `title` string, required: Display title for the shared dashboard.
      - `token` string, required: Token assigned to the shared dashboard.
      - `url` string, required: URL for the shared dashboard.
      - `viewing_preferences` SharedDashboardViewingPreferences, required: Display settings for the shared dashboard.
        - `high_density` boolean, required: Whether widgets are displayed in high-density mode.
        - `theme` 'system' | 'light' | 'dark', required: The theme of the shared dashboard view. `system` follows the viewer's system default.
    - `id` string, required: ID of the shared dashboard.
    - `relationships` SharedDashboardRelationships, required: Relationships of a shared dashboard.
      - `dashboard` SharedDashboardRelationshipDashboard, required: Dashboard associated with the shared dashboard.
        - `data` SharedDashboardRelationshipDashboardData, required: Dashboard relationship data.
          - `id` string, required: ID of the dashboard.
          - `type` 'dashboard', required: Included dashboard resource type.
      - `sharer` SharedDashboardRelationshipSharer, required: User who shared the dashboard.
        - `data` UserRelationshipData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'user', required: User resource type.
    - `type` 'shared_dashboard', required: Shared dashboard resource type.
  - `included` SharedDashboardIncluded[], required: Users and dashboards related to the shared dashboards.
    - union: Resource included with a shared dashboard.
      - SharedDashboardIncludedDashboard: Included dashboard resource.
        - `attributes` SharedDashboardIncludedDashboardAttributes, required: Attributes of the included dashboard.
          - `title` string, required: Dashboard title.
        - `id` string, required: ID of the dashboard.
        - `type` 'dashboard', required: Included dashboard resource type.
      - SharedDashboardIncludedUser: Included user resource.
        - `attributes` SharedDashboardIncludedUserAttributes, required: Attributes of the included user.
          - `handle` string, required: User handle.
          - `name` string, required: User display name.
        - `id` string, required: ID of the user.
        - `type` 'user', required: User resource type.

## Other responses

- `403`: Forbidden
- `404`: Dashboard Not Found
- `429`: Too many requests

---

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