# List

Launch stage: Beta

`GET /api/2.1/unity-catalog/{parent=software-artifacts/*}/versions`

Lists the versions of a software artifact.

API scopes: unity-catalog

## Path parameters

- `parent` (string, required)
  Resource name of the parent artifact, of the form
   `software-artifacts/{catalog}.{schema}.{artifact}`.

## Query parameters

- `page_token` (string, optional)
  Opaque continuation token from a previous response's next_page_token. Omit for the first page.
- `page_size` (int32, optional)
  Maximum number of versions to return. If omitted or set to 0, the page size defaults to 50.
   The maximum value is 50; values above 50 or below 0 are rejected.

## Returns

Returns a list of SoftwareArtifactVersion objects.

## Response

```json
{
  "software_artifact_versions": [
    {
      "digest": "string",
      "name": "string",
      "tags": [
        "string"
      ],
      "image_acceleration_details": {},
      "create_time": "string",
      "created_by": "string",
      "update_time": "string",
      "updated_by": "string"
    }
  ],
  "next_page_token": "string"
}
```