---
title: "Get artifact versions list"
method: GET
path: "/workspaces/{workspace_domain}/artifacts/{artifactId}/versions"
tags: ["Artifact Versions API"]
---

# Get artifact versions list

`GET /workspaces/{workspace_domain}/artifacts/{artifactId}/versions`

## Path parameters

- `workspace_domain` string, required
- `artifactId` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `sort_by` string
- `sort_direction` string

## Response `200`

- ArtifactVersionsView — Collection of artifact versions
  - `url` string — API endpoint to GET this object
  - `html_url` string — Web URL to view this object in Buddy.works
  - `versions` ShortArtifactVersionView[] — List of artifact versions
    - `url` string — API endpoint to GET this object
    - `html_url` string — Web URL to view this object in Buddy.works
    - `id` integer — The unique ID of the version (used in API endpoints)
    - `version` string — The version identifier (e.g., latest, v1.2.0, stable)
    - `size` integer — Size of the version content in bytes
    - `version_url` string — Direct URL to access the artifact version content. For CONTAINER artifacts, this is the registry URL (e.g., container.registry.sh/ttests/ubuntu:latest). For FILES artifacts, this is the HTTP server URL where the content is served (e.g., https://latest-my-artifact.bucket-1.registry.sh/)
    - `created_date` string, date-time — Version creation timestamp

## Changes

- **2026-08-04** `2426d67c249a` — 2 info
  - added the new optional `query` request parameter `sort_by`
  - added the new optional `query` request parameter `sort_direction`

[Change history](https://skmtc.dev/buddy/apis/buddy-api/changes/workspaces/:workspace_domain/artifacts/:artifactId/versions/get.md)

---

[API](https://skmtc.dev/buddy/apis/buddy-api.md) · [All operations](https://skmtc.dev/buddy/apis/buddy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/buddy/buddy-api/revisions/fa785a68f09d/schema)