---
title: "Batch stewardship state for a list of purls"
method: POST
path: "/packages:batch-stewardship"
tags: ["Stewardship"]
---

# Batch stewardship state for a list of purls

`POST /packages:batch-stewardship`

Returns lean stewardship state for up to 100 purls in one request. Purls not found in CDP return `null`.

## Request body

- object
  - `purls` string[], required

## Response `200`

Stewardship state keyed by purl. Unknown or invalid purls return `null`.

- object
  - `packages` object, required

## Other responses

- `400` — Validation error (e.g. more than 100 purls).
- `401` — Missing or invalid bearer token.
- `403` — Insufficient scopes.

## Changes

- **2026-07-17** (v1) `36d7585ff64c` — 1 warning
  - added the new `archived` enum value to the `packages/additionalProperties/oneOf[#/components/schemas/StewardshipSummary]/lifecycle` response property for the response status `200`
- **2026-06-23** (v1) `3272cbfaa72b` — 1 warning, 2 info
  - removed the optional property `packages/additionalProperties/oneOf[#/components/schemas/StewardshipSummary]/stewards/oneOf[subschema #1]/items/name` from the response with the `200` status
  - added the optional property `packages/additionalProperties/oneOf[#/components/schemas/StewardshipSummary]/stewards/oneOf[subschema #1]/items/displayName` to the response with the `200` status
  - added the optional property `packages/additionalProperties/oneOf[#/components/schemas/StewardshipSummary]/stewards/oneOf[subschema #1]/items/username` to the response with the `200` status
- **2026-06-16** (v1) `08763340c7f5` — 2 breaking
  - the response property `packages/additionalProperties/oneOf[#/components/schemas/StewardshipSummary]/stewards/oneOf[subschema #1]/items/name` became nullable for the status `200`
  - the response property `packages/additionalProperties/oneOf[#/components/schemas/StewardshipSummary]/stewards/oneOf[subschema #1]/items/name` became optional for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/linuxfoundation/apis/cdp-public-api-packages-stewardship/changes/packages:batch-stewardship/post.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)