Skip to main content

List Package Versions

List Package Versions​

To retrieve a list of all versions of a specific package, use the following REST API endpoint:

  • Endpoint: https://api.repoflow.io/package/<workspace-name>/<repo-name>/<package-name>/versions
  • Method: GET

Request Details​

This API retrieves the available versions of a package stored in the specified repository. Ensure that the repository type is local, as this endpoint is designed to work with local and virtual repositories only.

Example Response​

On success, the API returns an array of package version details with HTTP status 200:

[
  {
    "version": "0.1.0",
    "versionId": "63edca5d-8890-4413-8a0c-7cf0ec2bd2df",
    "createdAt": "2025-01-02T12:06:57.520627+00:00",
    "downloads": 12,
    "lastDownloadedAt": "2026-07-27T13:37:52.603724+00:00"
  },
  {
    "version": "0.2.5",
    "versionId": "2c8f4e1b-63a2-47d9-9f62-b7a0dbf9c41e",
    "createdAt": "2025-01-04T12:09:27.520621+00:00",
    "downloads": 0,
    "lastDownloadedAt": null
  }
]

Each entry in the array contains:

  • version: The version of the package.
  • versionId: The unique internal identifier for this specific version, which can be used in other API calls such as deleting a version.
  • createdAt: The timestamp when the version was created.
  • downloads: Number of downloads for this version.
  • lastDownloadedAt: Timestamp of the version's most recent download, or null if no download timestamp has been recorded.

Error Responses​

  • 404 Not Found: If the package is not found in the repository.
  • 500 Internal Server Error: If an unexpected error occurs during the request processing.