---
title: "Global KPI bar metrics"
method: GET
path: "/ossprey/metrics"
tags: ["Dashboard"]
---

# Global KPI bar metrics

`GET /ossprey/metrics`

Returns the seven aggregate metrics shown in the sticky KPI bar across all four dashboard tabs. Fetch once on page load; refresh after any write action.

## Response `200`

KPI metrics.

- object
  - `totalPackages` integer, required — Total critical packages (is_critical = true).
  - `criticalPackages` integer, required — Critical packages with at least one critical-severity advisory.
  - `coveragePercent` number, float, required — Percentage of critical packages with status in (assessing, active, needs_attention). One decimal place.
  - `coverageTrend` number, nullable — Percentage-point change vs. previous month. Null until snapshot mechanism is implemented.
  - `activeStewards` integer, required — COUNT(DISTINCT user_id) from stewardship_stewards where deleted_at IS NULL and stewardship status != inactive.
  - `unassignedCritical` integer, required — Critical packages with no stewardship row or status = unassigned.
  - `needsAttention` integer, required — Critical packages with status = needs_attention.
  - `escalated` integer, required — Critical packages with status = escalated.

## Other responses

- `401` — Missing or invalid bearer token.

---

[API](https://skmtc.net/linuxfoundation/apis/cdp-public-api-ossprey-admin-dashboard-v2.md) · [All operations](https://skmtc.net/linuxfoundation/apis/cdp-public-api-ossprey-admin-dashboard-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linuxfoundation/cdp-public-api-ossprey-admin-dashboard-v2/versions/0156203371f5/schema)