--- title: "ListObjectVersions" slug: "ncloudstorage-listobjectversions" updated: 2026-09-17T10:12:30Z published: 2026-09-17T10:12:30Z canonical: "api.ncloud-docs.com/ncloudstorage-listobjectversions" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # ListObjectVersions Available in Classic and VPC Get the metadata of all versions of an object in a Ncloud Storage bucket. Note It is only available in a bucket with version control enabled. ## Request This section describes the request format. The method and URI are as follows: | Method | URI | | --- | --- | | GET | - | ### Request headers For information about the headers common to all Ncloud Storage APIs, see [Ncloud Storage request headers](/docs/en/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94). ### Request query parameters You can use the following query parameters with your request: | Field | Type | Required | Description | | --- | --- | --- | --- | | `versions` | String | Required | Request version metadata query. - Enter only keys without values. | | `key-marker` | String | Optional | Query start criteria (object name) - The `NextKeyMarker` value from the previous response result or a random string can be entered. | | `version-id-marker` | String | Optional | Query start criteria (multipart upload ID) - `NextVersionIdMarker` value from the previous response result - When using it, it must be entered with `key-marker`. | | `max-keys` | String | Optional | Number of items per page - 1-1000 (default: 1000) | | `prefix` | String | Optional | Object name prefix | ### Request example The request example is as follows: ``` GET /?versions&max-keys=1 HTTP/1.1 Host: bucket.kr.ncloudstorage.com ``` ## Response This section describes the response format. ### Response headers For information about the headers common to all Ncloud Storage APIs, see [Ncloud Storage response headers](/docs/en/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94). ### Response body The response body includes the following data: | Field | Type | Required | Description | | --- | --- | --- | --- | | `ListBucketResult` | Object | - | Bucket list query result | | `ListBucketResult.Name` | String | - | Bucket name | | `ListBucketResult.Prefix` | String | - | Bucket name prefix - Display the input value if `prefix` is entered. | | `ListBucketResult.NextKeyMarker` | String | - | Next query criteria (object name) - If `IsTruncated` is `true`, enter that value in `key-marker` of the next request. | | `ListBucketResult.NextVersionIdMarker` | String | - | Next query criteria (object version ID) - If `IsTruncated` is `true`, enter that value in `version-id-marker` of the next request. | | `ListBucketResult.MaxKeys` | Integer | - | Number of items per page | | `ListBucketResult.IsTruncated` | Boolean | - | Whether next page exists - `true` \| `false` - `true`: It exists. - `false`: It doesn't exist. | | `ListBucketResult.DeleteMarker` | Array | - | [Object deletion marker information](/docs/en/ncloudstorage-listobjectversions#DeleteMarker) | | `ListBucketResult.Version` | Array | - | [Object version list](/docs/en/ncloudstorage-listobjectversions#Version) | #### `Version` The following describes `Version`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `IsLatest` | Boolean | - | Whether it is the latest version - `true` \| `false` - `true`: Latest version - `false`: Not latest version | | `Key` | String | - | Object name | | `LastModified` | String | - | Last modification date and time - ISO 8601 format | | `ETag` | String | - | Unique object identifier (entity tag) | | `Size` | Integer | - | Object size (byte) | | `StorageClass` | String | - | Storage class - `STANDARD` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `DEEP_ARCHIVE`: Archive Class | | `ChecksumAlgorithm` | String | - | Object checksum hash algorithm - `CRC64NVME`: CRC-64/NVME | | `ChecksumType` | String | - | Object checksum calculation type - `COMPOSITE` \| `FULL_OBJECT` - `COMPOSITE`: Multipart checksum - `FULL_OBJECT`: Full object checksum | | `VersionId` | String | - | Object version ID | #### `DeleteMarker` The following describes `DeleteMarker`. | Field | Type | Required | Description | | --- | --- | --- | --- | | `IsLatest` | Boolean | - | Whether it is the latest version - `true` \| `false` - `true`: Latest version - `false`: Not latest version | | `Key` | String | - | Object name | | `LastModified` | String | - | Creation date and time - ISO 8601 format | | `VersionId` | String | - | Deletion marker version ID | ### Response status codes For information about the HTTP status codes common to all Ncloud Storage APIs, see [Common Ncloud Storage response status codes](/docs/en/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C). ### Response example The response example is as follows: ``` HTTP/1.1 200 OK bucket 1000 false true test.xlsx 2025-05-19T08:02:12Z 91f1fe7f-****-****-****-9cc2c468d112 false test.xlsx 2025-05-19T03:06:04Z "2dd************************4f6181" 17423 STANDARD CRC64NVME FULL_OBJECT null true object.csv 2025-05-19T05:55:33Z "db7**********************5c35" 24 STANDARD CRC64NVME FULL_OBJECT null true object.jpg 2025-05-19T05:56:39Z "a3f******************************23" 2799 STANDARD CRC64NVME FULL_OBJECT null ```