Sign in

v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Dashboards

Get usage stats for a dashboard

Get usage statistics for a single dashboard. The response includes view counts, the most recent view and edit times, widget counts, and the dashboard quality score. View-count fields depend on Real User Monitoring (RUM) and are null or 0 in orgs without RUM.

get/api/v2/dashboards/{dashboard_id}/usage

Path parameters

dashboard_idstring required
Example:q5j-nti-fv6

The ID of the dashboard.

Response

OK

Example response

{
  "data": {
    "attributes": {
      "author": {
        "handle": "jane.doe@example.com",
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "Jane Doe"
      },
      "created_at": "2026-01-15T09:30:00.000Z",
      "dashboard_quality_score": 0.85,
      "edited_at": "2026-04-20T11:05:00.000Z",
      "org_id": 100,
      "title": "My production overview",
      "total_views": 42,
      "viewed_at": "2026-05-01T14:22:10.000Z",
      "viewer": {
        "handle": "jane.doe@example.com",
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "Jane Doe"
      },
      "widget_count": 12
    },
    "id": "q5j-nti-fv6",
    "type": "dashboards-usages"
  }
}