v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBGet usage stats for all dashboards
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
Maximum number of dashboards to return per page. Server-side maximum is 500; values above 500 return a 400 Bad Request.
Zero-based offset into the result set.
Return only dashboards whose last edit (edited_at) is strictly before this ISO 8601 timestamp (edited_at < value; boundary matches are excluded). Must include a timezone offset (for example, Z or +00:00); naive timestamps return HTTP 400.
Return only dashboards whose most recent view (viewed_at) is strictly before this ISO 8601 timestamp, including dashboards that have never been viewed. Must include a timezone offset; naive timestamps return HTTP 400. Orgs without Real User Monitoring (RUM) will see all dashboards returned by this filter.
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"
}
],
"links": {
"first": "https://api.datadoghq.com/api/v2/dashboards/usage?page[offset]=0&page[limit]=250",
"self": "https://api.datadoghq.com/api/v2/dashboards/usage"
},
"meta": {
"page": {
"first_offset": 0,
"last_offset": 900,
"limit": 100,
"next_offset": 100,
"offset": 0,
"prev_offset": 100,
"total": 1000,
"type": "offset_limit"
}
}
}