---
title: "lookup package versions by PURL"
method: POST
path: "/purls/bulk_lookup"
tags: ["packages"]
---

# lookup package versions by PURL

`POST /purls/bulk_lookup`

## Request

- Base URL: `https://packages.ecosyste.ms/api/v1`
- URL: `https://packages.ecosyste.ms/api/v1/purls/bulk_lookup`
- Auth: none declared

## Request body

- object
  - `purls` string[], required: package URLs to lookup (maximum 100)

## Response `200`

successful operation

- PurlLookupResult[]: results in the same order as the requested PURLs
  - `purl` string, required
  - `match_status` 'matched' | 'missing' | 'ambiguous', required
  - `version` PurlVersion
    - `name` string, required
    - `version` string, required
    - `purl` string, required
    - `license_expression` string, nullable
    - `identifiers` object, required
      - `purl` string
      - `integrity` string
    - `artifacts` object[], required
      - `download_url` string
      - `integrity` string
    - `dependencies` Dependency[], required
      - `id` integer, required
      - `ecosystem` string, required
      - `package_name` string, required
      - `requirements` string, nullable, required
      - `kind` string, nullable, required
      - `optional` boolean, nullable, required
    - `advisories` VersionAdvisory[], required
      - `uuid` string, nullable
      - `identifiers` string[], required
      - `url` string, nullable
      - `title` string, nullable
      - `severity` string, nullable
      - `affected` boolean, required
      - `fixed` boolean, required
      - `fixed_versions` string[], required

## Other responses

- `400`: missing PURLs parameter or too many PURLs

## Changes

- **2026-10-22** (v1) `b8fcfcb60191`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/changes/purls/bulk_lookup/post.md)

---

[API](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages.md) - [All operations](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/llms.txt) - [OpenAPI document](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/revisions/b8fcfcb60191?raw)