What metrics does the Dashboard show — and where do they come from?

Requires Basic

Quick answer

The Dashboard shows four metrics — Total Assets, Active Assets, In Maintenance, and Expiring Licenses —, plus the Asset Distribution by type and Recent Activity. All values relate exclusively to your current tenant and are calculated live from your inventory on every request.

Prerequisites

Required role All logged-in users

— every role can see the Dashboard. The numbers reflect the currently selected tenant. Programmatically, an API token with read access (scope read) is enough.

The Dashboard is part of the core and included in all plans. Individual tiles can still stay empty if the related module isn’t in your plan: “Expiring Licenses” only counts anything once the Software & Licenses module (Pro and above) is used.

Guide

GUI (web interface)

1. Open the Dashboard. Log in — Notory takes you straight to the Dashboard. The top entry, Dashboard, in the left-hand navigation brings you back here any time. The four KPI tiles sit at the top.

   • Total Assets — all assets belonging to the tenant.
   • Active Assets — assets with status Active.
   • In Maintenance — assets with status Maintenance.
   • Expiring Licenses — software licenses that expire within the next 30 days.

   Screenshot pending dashboard-kennzahlen-01 Dashboard with the four KPI tiles Total Assets, Active Assets, In Maintenance, Expiring Licenses

   The four KPI tiles at the top of the Dashboard.

2. Read the asset distribution and recent activity. Below that, a donut chart shows the Asset Distribution by type (Hardware, Software, Network …). Next to it, Recent Activity lists the latest changes from the log (audit log) — action, object, and time.

   Screenshot pending dashboard-kennzahlen-02 Donut chart of the asset distribution by type next to the list of recent activity

   Asset distribution by type and recent activity from the log.

3. Use it as an entry point. At the very bottom are the Quick Actions “Add Asset”, “Import Assets”, and “Search Assets” — the fastest way into the most common workflows.

API (curl)

A single call returns all metrics: GET /api/v1/dashboard/stats. The tenant is derived from the token or session; no parameters are needed.

Retrieve dashboard metrics

curl -H "Authorization: Bearer inv_dein_token" \
  https://demo.notory.io/api/v1/dashboard/stats

Response (200 OK, abridged)

{
  "total_assets": 128,
  "active_assets": 111,
  "maintenance_assets": 6,
  "expiring_licenses": 3,
  "asset_distribution": [
    { "type": "hardware", "count": 84 },
    { "type": "software", "count": 22 },
    { "type": "network", "count": 15 },
    { "type": "peripheral", "count": 7 }
  ],
  "recent_activity": [
    {
      "id": "a91f…",
      "action": "create",
      "entity_type": "asset",
      "entity_id": "a2f1c9e4-…",
      "ip_address": "203.0.113.24",
      "created_at": "2026-07-08T09:14:22Z",
      "user": null
    }
  ]
}

• total_assets / active_assets / maintenance_assets — the total count, and assets with status active and maintenance, respectively.
• expiring_licenses — licenses with an expiry date within the next 30 days.
• asset_distribution — one { type, count } pair per asset type (the basis of the donut chart).
• recent_activity — the tenant’s last 10 log entries.

Possible errors: 401 (token missing/invalid).

What happens behind the scenes?

• No storage, just a snapshot: The Dashboard doesn’t write anything. Every request calculates the numbers fresh from the current inventory — there’s no cache and no nightly refresh.
• Strictly tenant-scoped: Only data from your current tenant (tenant_id) is included. After switching tenants, the Dashboard shows the new tenant’s numbers.
• “In Maintenance” ≠ maintenance appointments: This tile counts assets with status Maintenance, not entries in the Maintenance module. An asset can have scheduled maintenance and still be Active.
• Activity comes from the audit log: Every write action (create, change, delete) is logged; the last ten entries appear here.

Related topics

• Dashboard — Overview
• How do I create an asset?
• Maintenance & Operations — maintenance appointments and operations
• Software & Licenses — where expiring licenses come from
• API introduction — authentication, base URL, error codes