---
title: "get a list of versions for a package"
method: GET
path: "/registries/{registryName}/packages/{packageName}/versions"
tags: ["packages"]
---

# get a list of versions for a package

`GET /registries/{registryName}/packages/{packageName}/versions`

## Path parameters

- `registryName` string, required
- `packageName` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `created_after` string, date-time
- `updated_after` string, date-time
- `published_after` string, date-time
- `published_before` string, date-time
- `created_before` string, date-time
- `updated_before` string, date-time
- `sort` string
- `order` string

## Response `200`

OK

- Version[]
  - `id` integer, required
  - `number` string, required
  - `published_at` string, nullable, required
  - `licenses` string, nullable, required
  - `integrity` string, nullable, required
  - `status` string, nullable, required
  - `download_url` string, nullable, required
  - `registry_url` string, nullable, required
  - `documentation_url` string, nullable, required
  - `install_command` string, nullable, required
  - `metadata` object, nullable, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `purl` string, required
  - `version_url` string, required
  - `related_tag` object, required

## Changes

- **2024-06-04** (v1) `ca5b5b8af733` — 2 info
  - added the new optional `query` request parameter `created_before`
  - added the new optional `query` request parameter `updated_before`
- **2024-05-13** (v1) `5fcad531d65a` — 3 info
  - the response property `items/related_tag` became required for the status `200`
  - the response property `items/version_url` became required for the status `200`
  - added the required property `items/id` to the response with the `200` status
- **2023-12-06** (v1) `7dfd47339a47` — 1 info
  - added the optional property `items/related_tag` to the response with the `200` status
- **2023-08-31** (v1) `5a9178560e61` — 1 breaking, 1 info
  - removed the required property `items/dependencies` from the response with the `200` status
  - added the optional property `items/version_url` to the response with the `200` status
- **2023-07-13** (v1) `9afba04d334a` — 1 info
  - added the new optional `query` request parameter `published_before`

[Full history](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/changes/registries/:registryName/packages/:packageName/versions/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/98c51ecb0201?raw)