---
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`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)