---
title: "Get a List of Versions"
method: GET
path: "/api/v1/versions"
tags: ["Version Management"]
---

# Get a List of Versions

`GET /api/v1/versions`

## Request

- Base URL: `https://api.dealhub.io`
- URL: `https://api.dealhub.io/api/v1/versions`
- Auth: HTTP bearer

Retrieve a list of Versions, with an option to filter by status. If no parameters are provided, it returns all versions.

## Query parameters

- `status` 'DRAFT' | 'ACTIVE' | 'DEACTIVATED'

## Response `200`

Success. Returns a list of version objects.

- Version[]
  - `name` string: Name of the version.
  - `comment` string: Comment provided during version creation.
  - `status` string: Status of the version.
  - `version_id` string: The unique identifier of the version.

## Other responses

- `400`: Bad Request. The `status` parameter has an unsupported value.
- `403`: Unauthenticated. The `Authorization` token is missing, invalid, or does not match the user.

---

[API](https://skmtc.dev/dealhub/apis/version-api.md) - [All operations](https://skmtc.dev/dealhub/apis/version-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/version-api/revisions/5cf310574705?raw)