---
title: "List all Artefacts Versions in the org."
method: GET
path: "/orgs/{orgId}/artefact-versions"
tags: ["public", "ArtefactVersion"]
---

# List all Artefacts Versions in the org.

`GET /orgs/{orgId}/artefact-versions`

Returns the Artefact Versions registered with your organization. If no elements are found, an empty list is returned.

## Path parameters

- `orgId` string, required

## Query parameters

- `name` string
- `reference` string
- `archived` boolean
- `type` string

## Response `200`

A list of Artefact Versions registered with your organization.

- ArtefactVersion[]
  - union — The details of an Artefact Version. The type field dictates the type of Artefact along with any additional fields.
    - object — Details of a Container Artefact Version
      - `type` string, required — The Artefact Version type.
      - `archived` boolean, required — If the Artefact Version is archived.
      - `artefact_id` string, required — The UUID of the Artefact.
      - `commit` string, required — (Optional) The commit ID the Artefact Version was built on.
      - `created_at` string — The time when the Artefact Version was added to Humanitec.
      - `created_by` string — The user ID of the user who added the Artefact Version to Humanitec.
      - `id` string, required — The UUID of the Artefact Version.
      - `name` string, required — The name of the Artefact.
      - `ref` string, required — (Optional) The ref the Artefact Version was built from.
      - `updated_at` string — The time when the Artefact Version was updated for the last time.
      - `updated_by` string — The user ID of the user who performed the last updated on the Artefact Version.
      - `version` string — (Optional) The version of the Artefact Version.
      - `digest` string, required — (Optional) The Artefact Version digest.
    - object — Details of a Workload Artefact Version
      - `type` string, required — The Artefact Version type.
      - `archived` boolean, required — If the Artefact Version is archived.
      - `artefact_id` string, required — The UUID of the Artefact.
      - `commit` string — (Optional) The commit ID the Artefact Version was built on.
      - `created_at` string — The time when the Artefact Version was added to Humanitec.
      - `created_by` string — The user ID of the user who added the Artefact Version to Humanitec.
      - `id` string, required — The UUID of the Artefact Version.
      - `name` string, required — The name of the Artefact.
      - `ref` string — (Optional) The ref the Artefact Version was built from.
      - `updated_at` string — The time when the Artefact Version was updated for the last time.
      - `updated_by` string — The user ID of the user who performed the last updated on the Artefact Version.
      - `version` string — (Optional) The version of the Artefact Version.

## Other responses

- `400` — Bad request.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)