---
title: "lookup a package version by PURL"
method: GET
path: "/purls/lookup"
tags: ["packages"]
---

# lookup a package version by PURL

`GET /purls/lookup`

## Request

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

## Query parameters

- `purl` string, required

## Response `200`

successful operation

- PurlLookupResult
  - `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 PURL parameter

## Changes

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

[Operation history](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/changes/purls/lookup/get.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)