---
title: "List packages"
method: GET
path: "/packages"
tags: ["Packages"]
---

# List packages

`GET /packages`

## Query parameters

- `page` integer
- `pageSize` integer
- `ecosystem` string
- `lifecycle` 'active' | 'stable' | 'declining' | 'abandoned' | 'archived'
- `busFactor1Only` boolean
- `staleOnly` boolean
- `unstewardedOnly` boolean
- `sortBy` 'name' | 'health' | 'impact' | 'openVulns'
- `sortDir` 'asc' | 'desc'

## Response `200`

Paginated list of packages.

- object
  - `page` integer, required
  - `pageSize` integer, required
  - `total` integer, required
  - `filters` object, required
    - `ecosystem` string, nullable
    - `lifecycle` string, nullable
    - `busFactor1Only` boolean
    - `staleOnly` boolean
    - `unstewardedOnly` boolean
  - `sort` object, required
    - `by` string
    - `dir` string
  - `packages` PackageListItem[], required
    - `purl` string, required — Used to call GET /packages/detail?purl= when a row is clicked.
    - `name` string, required
    - `ecosystem` string, required
    - `health` object
      - `score` integer, nullable, required — Health score (0–100). Tinybird composite score when enriched, OpenSSF Scorecard × 10 otherwise. Null if neither is available.
      - `label` 'excellent' | 'healthy' | 'fair' | 'concerning' | 'critical', required — Tinybird band when enriched (excellent ≥85, healthy 70–84, fair 50–69, concerning 30–49, critical <30), scorecard band otherwise.
    - `impact` integer, nullable
    - `lifecycle` 'active' | 'stable' | 'declining' | 'abandoned' | 'archived' | 'null', nullable
    - `maintainerBusFactor` integer, nullable
    - `openVulns` OpenVulns — Open vulnerability counts by severity from advisory_packages + advisories.
      - `low` integer, required
      - `medium` integer, required
      - `high` integer, required
      - `critical` integer, required
    - `stewardshipId` string, nullable — Stewardship ID. Required to call mutation endpoints (assign/escalate/status). Null if no stewardship row exists.
    - `stewardship` 'unassigned' | 'open' | 'assessing' | 'active' | 'needs_attention' | 'escalated' | 'blocked' | 'inactive'
    - `stewards` Steward[] — Assigned stewards. Empty array if none.
      - `userId` string, required — Auth0 sub of the assigned steward.
      - `username` string, nullable — Username of the steward. Null if not available.
      - `displayName` string, nullable — Display name of the steward. Null if not available.
      - `role` 'lead' | 'co_steward', required
      - `assignedAt` string, date-time, required

## Other responses

- `400` — Validation error (e.g. invalid query parameters).
- `401` — Missing or invalid bearer token.
- `403` — Insufficient scopes.

## Changes

- **2026-07-17** (v1) `36d7585ff64c` — 1 breaking, 1 warning, 3 info
  - the `packages/items/health` response's property type/format changed from `integer, null`/`` to `object`/`` for status `200`
  - added the new `archived` enum value to the `packages/items/lifecycle` response property for the response status `200`
  - added the new enum value `archived` to the `query` request parameter `lifecycle`
  - added the required property `packages/items/health/label` to the response with the `200` status
  - …1 more
- **2026-06-23** (v1) `3272cbfaa72b` — 1 info
  - response property `packages/items/stewards` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-06-16** (v1) `08763340c7f5` — 2 breaking, 1 info
  - the response property `packages/items/stewards/oneOf[subschema #1]/items/name` became nullable for the status `200`
  - the response property `packages/items/stewards/oneOf[subschema #1]/items/name` became optional for the status `200`
  - added the optional property `packages/items/stewardshipId` to the response with the `200` status
- **2026-06-11** (v1) `5ade51496c11` — 1 warning, 1 info
  - removed the optional property `packages/items/steward` from the response with the `200` status
  - added the optional property `packages/items/stewards` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/linuxfoundation/apis/cdp-public-api-packages-stewardship/changes/packages/get.md)

---

[API](https://skmtc.dev/linuxfoundation/apis/cdp-public-api-packages-stewardship.md) · [All operations](https://skmtc.dev/linuxfoundation/apis/cdp-public-api-packages-stewardship/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/linuxfoundation/cdp-public-api-packages-stewardship/revisions/36d7585ff64c/schema)