---
title: "Get usage stats for all dashboards"
method: GET
path: "/api/v2/dashboards/usage"
tags: ["Dashboards"]
---

# Get usage stats for all dashboards

`GET /api/v2/dashboards/usage`

Get paginated usage statistics for every dashboard in the caller's organization. Use `page[limit]` and `page[offset]` to walk the result set. Use `filter[edited_before]` or `filter[viewed_before]` to narrow results by recency. View-count fields depend on Real User Monitoring (RUM) and are `null` or `0` in orgs without RUM.

## Query parameters

- `page[limit]` integer
- `page[offset]` integer
- `filter[edited_before]` string
- `filter[viewed_before]` string

## Response `200`

OK

- ListDashboardsUsageResponse — Paginated list of dashboard usage records.
  - `data` DashboardUsage[], required — Dashboard usage records, one per dashboard in the caller's organization.
    - `attributes` DashboardUsageAttributes, required — Usage statistics for a dashboard. The `viewer` field and all view-count fields (`total_views`, `viewed_at`, `total_views_by_type`) are populated only when Real User Monitoring (RUM) is active for the org.
      - `author` DashboardUsageUser, nullable — A user referenced from a dashboard usage record (author or viewer).
        - `handle` string — Datadog handle (login) of the user.
        - `id` string — The user ID.
        - `is_disabled` boolean — Whether the user account is disabled.
        - `name` string — Display name of the user.
      - `created_at` string, date-time, nullable — When the dashboard was created.
      - `dashboard_quality_score` number, double, nullable — The dashboard quality score, or `null` when no score is available.
      - `edited_at` string, date-time, nullable — When the dashboard was most recently edited.
      - `org_id` integer, required — The Datadog organization that owns the dashboard.
      - `teams` string[], nullable — Teams the dashboard is tagged with.
      - `title` string — The dashboard title.
      - `total_views` integer — Total view count for the dashboard. Counts only views captured by Real User Monitoring (RUM); `0` in orgs without RUM.
      - `total_views_by_type` object, nullable — View counts keyed by view type (`in_app`, `embed`, `public`, `shared`, `api`, `unknown`). Counts only views captured by Real User Monitoring (RUM); empty in orgs without RUM.
      - `viewed_at` string, date-time, nullable — When the dashboard was most recently viewed. Populated only when Real User Monitoring (RUM) is active for the org; `null` in orgs without RUM.
      - `viewer` DashboardUsageUser, nullable — A user referenced from a dashboard usage record (author or viewer).
        - `handle` string — Datadog handle (login) of the user.
        - `id` string — The user ID.
        - `is_disabled` boolean — Whether the user account is disabled.
        - `name` string — Display name of the user.
      - `widget_count` integer, nullable — The total number of widgets on the dashboard.
      - `widget_count_by_type` object, nullable — Widget counts keyed by widget type. The map includes group widgets and widgets without requests.
    - `id` string, required — The dashboard ID.
    - `type` 'dashboards-usages', required — The type of the resource. Always `dashboards-usages`.
  - `links` ListDashboardsUsageResponseLinks — Pagination links for a list of dashboard usage records.
    - `first` string — Link to the first page.
    - `last` string, nullable — Link to the last page, or `null` if the total is unknown.
    - `next` string, nullable — Link to the next page. Absent when there is no next page.
    - `prev` string, nullable — Link to the previous page. Absent when there is no previous page.
    - `self` string — Link to the current page.
  - `meta` ListDashboardsUsageResponseMeta, required — Pagination metadata for a list of dashboard usage records.
    - `page` PaginationMetaPage — Offset-based pagination schema.
      - `first_offset` integer — Integer representing the offset to fetch the first page of results.
      - `last_offset` integer, nullable — Integer representing the offset to fetch the last page of results.
      - `limit` integer — Integer representing the number of elements to be returned in the results.
      - `next_offset` integer, nullable — Integer representing the index of the first element in the next page of results. Equal to page size added to the current offset.
      - `offset` integer — Integer representing the index of the first element in the results.
      - `prev_offset` integer, nullable — Integer representing the index of the first element in the previous page of results.
      - `total` integer, nullable — Integer representing the total number of elements available.
      - `type` 'offset_limit' — The pagination type used for offset-based pagination.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `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)