---
title: "Lookup details for a set of package releases."
method: POST
path: "/v1/releases/lookup"
tags: ["Releases"]
---

# Lookup details for a set of package releases.

`POST /v1/releases/lookup`

Lookup details for a set of package releases

## Request body

- union
  - object
    - `releases` Release[], required — The releases being looked up.
      - `platform` string, required
      - `name` string, required
      - `version` string, required
  - object
    - `purls` string[], required — Array of properly formatted PURLs

## Response `200`

Details of the package releases found

- object
  - `releases` object
    - `name` string
    - `platform` string
    - `version` string
    - `published_at` string, nullable
    - `purl` string
    - `repository` object
      - `url` string, nullable
      - `source` 'package_manager' | 'human_verified'
    - `tidelift_recommendation` 'recommended' | 'not_recommended' | 'not_assessed', nullable
    - `violations` Violations[]
      - union[]
        - union
          - AllowedLicensesViolation
            - `catalog_standard` string, required
            - `violation_id` string, required
            - `title` string, required
            - `package_name` string
            - `package_platform` string
            - `version` string
            - `task_id` string, nullable
            - `license` string, required
          - DeprecationViolation
            - `catalog_standard` string, required
            - `violation_id` string, required
            - `title` string, required
            - `package_name` string
            - `package_platform` string
            - `version` string
            - `task_id` string, nullable
            - `deprecation` object, required
              - …
          - EOLPackagesViolation
            - `catalog_standard` string, required
            - `violation_id` string, required
            - `title` string, required
            - `package_name` string
            - `package_platform` string
            - `version` string
            - `task_id` string, nullable
            - `eol_package` object, required
              - …
          - IdentifiedLicensesViolation
            - `catalog_standard` string, required
            - `violation_id` string, required
            - `title` string, required
            - `package_name` string
            - `package_platform` string
            - `version` string
            - `task_id` string, nullable
            - `original_license` string, nullable, required
            - `repository_url` string, nullable, required
          - UpToDateViolation
            - `catalog_standard` string, required
            - `violation_id` string, required
            - `title` string, required
            - `package_name` string
            - `package_platform` string
            - `version` string
            - `task_id` string, nullable
            - `up_to_date` object, required
              - …
          - VulnerabilitiesViolation
            - `catalog_standard` string, required
            - `violation_id` string, required
            - `title` string, required
            - `package_name` string
            - `package_platform` string
            - `version` string
            - `task_id` string, nullable
            - `vulnerability` object, required
              - …
    - `license` object
      - `expression` string
      - `source` 'corrected_by_tidelift' | 'researched_by_tidelift' | 'valid_spdx' | 'tidelift_researching' | 'overridden_by_organization' | 'verified_by_maintainer'
    - `nearest_recommended_release` object, nullable
      - `version` string
      - `published_at` string, date-time, nullable
    - `lookup_name` string — The package name passed into the API that matches this Release
  - `missing_releases` Release[]
    - `platform` string, required
    - `name` string, required
    - `version` string, required

## Other responses

- `400` — Request body format incorrect or more than 1000 releases requested.
- `401` — Unauthorized
- `403` — 403 Forbidden

---

[API](https://skmtc.net/tidelift/apis/tidelift-external-api.md) · [All operations](https://skmtc.net/tidelift/apis/tidelift-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tidelift/tidelift-external-api/revisions/5f36bed372bb/schema)