Sign in

v1

latestOpenAPI 3.1.02026-07-174824.1 KB
Packages

Filtered paginated package list

Returns a paginated, filtered, sorted list of critical packages with their stewardship state and risk signals.

Used by three tabs:

  • Queue tab — full table with all filters

  • Triage Board — one request per status column, fired in parallel (?status=X&pageSize=50)

  • Summary panel — click-through navigates to Queue with pre-filled filter

The response always includes statusCounts — per-status counts computed without the active status filter, used to drive the tab bar badge numbers.

get/ossprey/packages

Query parameters

pageinteger
pageSizeinteger
namestring

Case-insensitive substring search on package name.

ecosystemstring

Filter by package ecosystem. Not validated server-side — any ecosystem stored in the DB is accepted.

lifecycle'active' | 'stable' | 'declining' | 'abandoned' | 'archived'
status'unassigned' | 'open' | 'assessing' | 'active' | 'needs_attention' | 'escalated' | 'blocked' | 'inactive'

Filter by stewardship status. unassigned includes packages with no stewardship row (s.id IS NULL).

healthBand'excellent' | 'healthy' | 'fair' | 'concerning' | 'critical'

Tinybird band when enriched (excellent ≥85, healthy 70–84, fair 50–69, concerning 30–49, critical <30). Falls back to scorecard thresholds: null or < 3.0 → critical · < 5.0 → concerning · < 7.0 → fair · ≥ 7.0 → healthy.

vulnSeverity'any' | 'high' | 'critical' | 'none'

any = at least one open advisory · high = worst rank ≥ HIGH · critical = worst rank = CRITICAL · none = zero advisories.

staleOnlyboolean

Return only packages with no release in ≥ 18 months.

unstewardedOnlyboolean

Return only packages with status = unassigned or no stewardship row.

busFactor1Onlyboolean

Return only packages with exactly one maintainer.

sortBy'risk' | 'name' | 'impact' | 'openVulns' | 'health'
sortDir'asc' | 'desc'

Response

Paginated package list.

totalinteger required
pageinteger required
pageSizeinteger required

Example response

{
  "rows": [
    {
      "purl": "pkg:npm/lodash@4.17.21",
      "name": "lodash",
      "ecosystem": "npm",
      "stewardshipId": "4501",
      "openVulns": 3,
      "maintainerCount": 2,
      "criticalityScore": 0.94,
      "impact": 94,
      "scorecardScore": 5.2,
      "health": {
        "score": 52,
        "label": "fair"
      },
      "lifecycle": "active",
      "lastActivity": {
        "type": "state_changed",
        "content": "Moved to active stewardship"
      },
      "stewards": [
        {
          "userId": "auth0|abc123"
        }
      ]
    }
  ],
  "total": 1842,
  "page": 1,
  "pageSize": 25
}