Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Object Storage API, Amazon S3-compatible REST: ListObjectVersions

Written by
Updated at May 6, 2026

Returns metadata for all versions of objects in the bucket.
You can also use request parameters as a selection criterion to return metadata about a subset of object versions.

For more information on getting started with the API and the general request format, see How to use the S3 API.

Request

GET /{bucket}?versions&delimiter=Delimiter&encoding-type=EncodingType&key-marker=KeyMarker&max-keys=MaxKeys&prefix=Prefix&version-id-marker=VersionIdMarker HTTP/2

Path parameters

Parameter Description
bucket Bucket name.

Query parameters

All parameters listed in the table are optional.

Parameter Description
delimiter Delimiter character.

If this parameter is specified, Object Storage interprets the key as a file path, where folders are separated by the delimiter character. In the response, the user will get a list of files and folders in the bucket. Files will be output in the Contents elements, and folders in the CommonPrefixes elements.

If the request also specifies the prefix parameter, Object Storage will return a list of files and folders in the prefix folder.
encoding-type Encoding of server responses.

Object Storage can encode responses in the format requested by the client.

Possible values: url.
key-marker Key the output starts from.

In the output, Object Storage will leave the keys starting from the one that follows key-marker.
max-keys Maximum number of elements in a response.

By default, Object Storage outputs no more than 1,000 Contents and CommonPrefixes elements. This parameter should be used if you need to get less than 1,000 elements per response.

If the selection criteria are met by more keys than the output has room for, the response contains <IsTruncated>true</IsTruncated>.

To get all output elements, if there are more than max-keys of them, make several consecutive requests to Object Storage with the key-marker parameter, where for each request key-marker and version-id-marker are equal to the values of the NextKeyMarker and NextVersionIdMarker elements from the previous response.
prefix String to start the key from.

Object Storage selects only those keys that start with prefix.

Can be used simultaneously with the delimiter parameter. In this case, the output logic is the same as that specified in the delimiter parameter description.
version-id-marker Object version the output starts from.

In the output, Object Storage will leave the versions starting from the one that follows version-id-marker.

Headings

Use only common headers in your requests.

Response

Headers

Responses can only contain common headers.

Response codes

For a list of possible responses, see Responses.

A successful response contains additional data in XML format with the schema described below.

Data schema

<?xml version="1.0" encoding="UTF-8"?>
<ListVersionsResult>
   <IsTruncated>boolean</IsTruncated>
   <KeyMarker>string</KeyMarker>
   <VersionIdMarker>string</VersionIdMarker>
   <NextKeyMarker>string</NextKeyMarker>
   <NextVersionIdMarker>string</NextVersionIdMarker>
   <Version>
      <ETag>string</ETag>
      <IsLatest>boolean</IsLatest>
      <Key>string</Key>
      <LastModified>timestamp</LastModified>
      <Owner>
         <DisplayName>string</DisplayName>
         <ID>string</ID>
      </Owner>
      <Size>integer</Size>
      <StorageClass>string</StorageClass>
      <VersionId>string</VersionId>
   </Version>
   ...
   <DeleteMarker>
      <IsLatest>boolean</IsLatest>
      <Key>string</Key>
      <LastModified>timestamp</LastModified>
      <Owner>
         <DisplayName>string</DisplayName>
         <ID>string</ID>
      </Owner>
      <VersionId>string</VersionId>
   </DeleteMarker>
   ...
   <Name>string</Name>
   <Prefix>string</Prefix>
   <Delimiter>string</Delimiter>
   <MaxKeys>integer</MaxKeys>
   <CommonPrefixes>
      <Prefix>string</Prefix>
   </CommonPrefixes>
   ...
   <EncodingType>string</EncodingType>
</ListVersionsResult>
Element Description
ListVersionsResult Root element.
CommonPrefixes Key name part identified when processing the delimiter and prefix request parameters.

Path: /ListVersionsResult/CommonPrefixes.
DeleteMarker Container for an object that is a delete marker.

Path: /ListVersionsResult/DeleteMarker.
Delimiter Value of the delimiter query parameter.

Path: /ListVersionsResult/Delimiter.
EncodingType Encoding used by Object Storage to provide a key in an XML response.

You will get this tag if the client provided the encoding-type parameter in the request.

Path: /ListVersionsResult/EncodingType.
IsTruncated Flag indicating an incomplete list.

If IsTruncated is true, it means Object Storage has returned an incomplete list of parts.

Path: /ListVersionsResult/IsTruncated.
KeyMarker The last key returned in the incomplete response.

Path: /ListVersionsResult/KeyMarker.
MaxKeys Value of the max-keys query parameter.

Path: /ListBucketResult/MaxKeys.
Name Bucket name.

Path: /ListBucketResult/Name.
NextKeyMarker Value to insert in the key-marker query parameter to get the next part of the list, if the entire list does not fit into the current response.

Path: /ListBucketResult/NextMarker.
NextVersionIdMarker Value to insert in the version-id-marker query parameter to get the next part of the list, if the entire list does not fit into the current response.

Path: /ListBucketResult/NextVersionIdMarker.
Prefix Value of the prefix query parameter.

Path: /ListBucketResult/Prefix.
Version Object version.

Path: /ListBucketResult/Version.
VersionIdMarker Marks the last version of the key returned in the truncated response.

Path: /ListBucketResult/VersionIdMarker.

See also

Previous
GetBucketLogging
Next
PutObjectLockConfiguration