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

# Changes to get a list of versions for a package

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 78 revisions.

- **2026-10-14** (v1) `8ab05a729410`: 1 info
- **2026-03-02** (v1) `705144173134`: 1 breaking, 4 info
- **2025-11-22** (v1) `7acaf0550652`: 1 info
- **2024-06-04** (v1) `ca5b5b8af733`: 2 info
- **2024-05-13** (v1) `5fcad531d65a`: 3 info
- **2023-12-06** (v1) `7dfd47339a47`: 1 info
- **2023-08-31** (v1) `5a9178560e61`: 1 breaking, 1 info
- **2023-07-13** (v1) `9afba04d334a`: 1 info
- **2023-04-12** (v1) `f34896f8c36a`: 1 info
- **2023-03-24** (v1) `fc805bcf39c9`: 12 breaking
- **2023-03-21** (v1) `e26b41e68e46`: 18 info
- **2022-12-06** (v1) `60f7e5d64a19`: 1 info
- **2022-11-21** (v1) `9559eee0f679`: 1 info

## Changes

- **2026-10-14** (v1) `8ab05a729410`: 1 info
  - added the required property `items/advisories` to the response with the `200` status
- **2026-03-02** (v1) `705144173134`: 1 breaking, 4 info
  - the `query` request parameter `sort` was restricted to a list of enum values
  - added the new enum value `created_at` to the `query` request parameter `sort`
  - added the new enum value `number` to the `query` request parameter `sort`
  - added the new enum value `published_at` to the `query` request parameter `sort`
  - added the new enum value `updated_at` to the `query` request parameter `sort`
- **2025-11-22** (v1) `7acaf0550652`: 1 info
  - added the required property `items/codemeta_url` to the response with the `200` status
- **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`
- **2023-04-12** (v1) `f34896f8c36a`: 1 info
  - added the required property `items/dependencies/items/ecosystem` to the response with the `200` status
- **2023-03-24** (v1) `fc805bcf39c9`: 12 breaking
  - the response property `items/dependencies/items/kind` became nullable for the status `200`
  - the response property `items/dependencies/items/optional` became nullable for the status `200`
  - the response property `items/dependencies/items/requirements` became nullable for the status `200`
  - the response property `items/documentation_url` became nullable for the status `200`
  - the response property `items/download_url` became nullable for the status `200`
  - the response property `items/install_command` became nullable for the status `200`
  - the response property `items/integrity` became nullable for the status `200`
  - the response property `items/licenses` became nullable for the status `200`
  - the response property `items/metadata` became nullable for the status `200`
  - the response property `items/published_at` became nullable for the status `200`
  - the response property `items/registry_url` became nullable for the status `200`
  - the response property `items/status` became nullable for the status `200`
- **2023-03-21** (v1) `e26b41e68e46`: 18 info
  - the response property `items/created_at` became required for the status `200`
  - the response property `items/dependencies` became required for the status `200`
  - the response property `items/dependencies/items/kind` became required for the status `200`
  - the response property `items/dependencies/items/optional` became required for the status `200`
  - the response property `items/dependencies/items/package_name` became required for the status `200`
  - the response property `items/dependencies/items/requirements` became required for the status `200`
  - the response property `items/documentation_url` became required for the status `200`
  - the response property `items/download_url` became required for the status `200`
  - the response property `items/install_command` became required for the status `200`
  - the response property `items/integrity` became required for the status `200`
  - the response property `items/licenses` became required for the status `200`
  - the response property `items/metadata` became required for the status `200`
  - the response property `items/number` became required for the status `200`
  - the response property `items/published_at` became required for the status `200`
  - the response property `items/purl` became required for the status `200`
  - the response property `items/registry_url` became required for the status `200`
  - the response property `items/status` became required for the status `200`
  - the response property `items/updated_at` became required for the status `200`
- **2022-12-06** (v1) `60f7e5d64a19`: 1 info
  - added the optional property `items/purl` to the response with the `200` status
- **2022-11-21** (v1) `9559eee0f679`: 1 info
  - api tag `packages` added

---

[Operation](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/docs/registries/:registryName/packages/:packageName/versions/get.md) - [API](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages.md) - [Page](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-packages/changes/registries/:registryName/packages/:packageName/versions/get)
