---
title: "get a list of recently published versions from a registry"
method: GET
path: "/registries/{registryName}/versions"
tags: ["packages"]
---

# get a list of recently published versions from a registry

`GET /registries/{registryName}/versions`

## Path parameters

- `registryName` 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

- VersionWithPackage[]
  - `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
  - `latest` boolean, required
  - `version_url` string, required
  - `package_url` string, required

## Changes

- **2024-07-15** (v1) `ceed01bf22b5` — 1 breaking, 1 info
  - removed the required property `items/package` from the response with the `200` status
  - added the required property `items/package_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) `275884c3101a` — 2 info
  - the response property `items/version_url` became required for the status `200`
  - added the required property `items/latest` to the response with the `200` status
- **2024-05-13** (v1) `5fcad531d65a` — 2 info
  - added the required property `items/id` to the response with the `200` status
  - added the required property `items/package/id` to the response with the `200` status
- **2024-03-18** (v1) `a055783c5955` — 2 info
  - added the required property `items/package/funding_links` to the response with the `200` status
  - added the required property `items/package/status` to the response with the `200` status

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