AssetCenter
Dashboard reports
Read the same summaries, charts, and lists as the AssetCenter dashboard through the public API.
Last updated
Reports
Dashboard report endpoints return the organization-wide figures behind the AssetCenter dashboard: status counts, charts, upcoming end-of-life dates and expirations, subscription cost, recent activity, and tracked assets. They are read-only and always cover the token’s organization. Reading them never changes anyone’s dashboard layout or preferences.
Endpoints and permissions
Every report requires reports:read plus the Read permission for the records it reports on.
| Report | Endpoint | Permissions |
|---|---|---|
| Get the dashboard summary | GET /api/v1/dashboard |
reports:read and all four inventory Read permissions: assets:read, people:read, locations:read, and subscriptions:read |
| Get dashboard status counts | GET /api/v1/dashboard/top-cards |
reports:read and all four inventory Read permissions: assets:read, people:read, locations:read, and subscriptions:read |
| Get the deployed assets chart | GET /api/v1/dashboard/deployed-assets-chart |
reports:read and assets:read |
| List assets reaching end of life | GET /api/v1/dashboard/assets-eol |
reports:read and assets:read |
| List expiring warranties | GET /api/v1/dashboard/expiring-warranties |
reports:read and assets:read |
| List expiring contracts | GET /api/v1/dashboard/expiring-contracts |
reports:read and subscriptions:read |
| Get subscription cost by month | GET /api/v1/dashboard/subscription-cost |
reports:read and subscriptions:read |
| List recent activity | GET /api/v1/dashboard/recent-activity |
reports:read and all four inventory Read permissions: assets:read, people:read, locations:read, and subscriptions:read |
| List tracked assets on the map | GET /api/v1/dashboard/gps-assets |
reports:read, assets:read, and assets:tracking |
New Full Access keys include reports:read; Read Only and existing keys do not. Create a replacement key to grant report access. GPS reports also need assets:tracking and an organization with GPS tracking enabled.
Timeframes
The list reports take a timeframe measured from today in UTC:
| Report | timeframe values |
Default |
|---|---|---|
| End of life, warranties, contracts | 1, 3, 6, 12, 24, or 36 months ahead, or year for the rest of this calendar year |
3 |
| Subscription cost | 3, 6 months back, ytd, year (12 months back), 2year, 3year, or all |
3 |
| Recent activity | 1, 3, 6, or 12 months back, or all |
1 |
List reports use the usual page and per_page pagination with data, meta, and links.