> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listing Versions

> List all versions associated with a specific product.

> [!WARNING]
>
> You are reading the docs of Galtea 5.15. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/version/list.md).

## Returns

Returns a list of [Version](https://docs.galtea.ai/v5.15/concepts/product/version.md) objects for the given product. Each object carries the version's `number`, its product-local identity. On a self-hosted deployment older than version numbers, `number` is `None`.

## Example

```python theme={"system"}
versions = galtea.versions.list(product_id=product_id, limit=5)
```

## Parameters

**product\_id** `string | list[string]`

The ID or IDs of the product(s) for which you want to list versions.

**from\_created\_at** `str | int` (default: None)

Filter versions created at or after this timestamp. Accepts ISO 8601 string (e.g., `'2024-01-01T00:00:00Z'`) or Unix timestamp in seconds. Can be used independently or together with `to_created_at`.

**to\_created\_at** `str | int` (default: None)

Filter versions created at or before this timestamp. Accepts ISO 8601 string (e.g., `'2024-12-31T23:59:59Z'`) or Unix timestamp in seconds. Can be used independently or together with `from_created_at`.

**sort\_by\_created\_at** `string`

Sort versions by creation date. Valid values are "asc" and "desc".

**offset** `int` (default: 0)

Number of versions to skip before starting to collect results. Use for pagination.

**Default:** `0` (start from the beginning)

**limit** `int` (default: 10000)

Maximum number of versions to return in a single request.

**Default:** `10000`

**id** `string | list[string]` (default: None)

The ID or IDs of the version(s) to retrieve.

**parent\_version\_id** `string | list[string]` (default: None)

Filter versions by their parent [version](https://docs.galtea.ai/v5.15/concepts/product/version.md#version-lineage). Pass one or more parent IDs to return only the revisions iterated from those parents. This is a refinement filter, so you must still pass `product_id` or `id`.

> [!NOTE]
>
> At least one of the 2 filter parameters (`product_id`, `id`) described above must be passed to the method


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.