---
title: "List Object Versions"
url: https://docs.catalyst.zoho.com/en/sdk/python/v1/cloud-scale/stratus/list-object-versions/
description: "This page lists the Python SDK method to get versions of an object."
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /en/sdk/java/v1/cloud-scale/stratus/get-object-versions/
  - name: "JavaScript SDK Documentation"
    url: /en/sdk/javascript/v1/cloudscale/stratus/rename-move/
  - name: "iOS SDK"
    url: /en/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /en/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

# List Object Versions

### List All Versions of an Object Through Pagination

Enabling [Versioning](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) in a bucket allows you to store multiple versions of the same object in the bucket. Each version of the object will have its own `versionId`. This SDK method allows you to get all the existing versions of an object present in a bucket by pagination.

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
			<th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`next_token`</td>
			<td>**String**</td>
			<td>Will hold the value to determine the next set of versions.</td>
		</tr>
		<tr>
			<td>`max_versions`</td>
			<td>**int**</td>
			<td>An **Optional** parameter. Will hold the value of the maximum number of versions of the object that can be listed per iteration.</td>
		</tr>
	</tbody>
</table>

```python
def list_my_paged_versions(max_versions = None, next_token= None):
        res = object_ins.list_paged_versions(max_versions, next_token)
        print(res)
        if not res['is_truncated']: # return 'true' if more versions are available for the object. Return 'false' no more versions available for the object
                return
        list_my_paged_versions(max_versions, next_token)
list_my_paged_versions(2)
```

#### Example Response

```json
{
    "key": "downloaded_file.json",
    "versions_count": 2,
    "max_versions": "2",
    "is_truncated": "False",
    "next_continuation_token": "4YpUdkktt2UeWp6MwEK1LZXELnuVhunHLnGgX29uvszwtJEQE2gVDJYyRiLdUmhNst",
    "version": [
        {
            "version_id": "01hyfh12njtpyvzwq6p1fd2d8s",
            "is_latest": "True",
            "last_modified": "May 22, 2024 12:20 PM",
            "size": 1,
            "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
        },
        {
            "version_id": "01hyfh0xkvwkxxsjfceef201xa",
            "is_latest": "False",
            "last_modified": "May 22, 2024 12:20 PM",
            "size": "1",
            "etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
        }
    ]
}
```

### List All Versions of the Object Through Iteration

You can use the following SDK method to get all available versions of the object in a single call.

> **Info:** To use this SDK method, you need intialize it with **Admin** scope. You can learn more about this requirement from this [section](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)

```python
versions = object_ins.list_iterable_versions(2)
for key in versions:
     print(key)
```

#### Example Response

```json

{
	"version_id": "01hyfh12njtpyvzwq6p1fd2d8s",
 	"is_latest": "True", 
	"last_modified": "May 22,2024 12:20 PM",
	"size": "1", 
	"etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
}
{
	"version_id": "01hyfh0xkvwkxxsjfceef201xa",
	"is_latest": "False",
    "last_modified": "May 22, 2024 12:20 PM",
    "size": "1",
	"etag": "9af7c117d9de9a06fba7a5f1ea5fcc2d"
}
```