---
title: "ListObjectsV2"
slug: "storage-objectstorage-listobjectsv2"
tags: ["Object Storage"]
updated: 2026-09-17T10:12:27Z
published: 2026-09-17T10:12:27Z
canonical: "api.ncloud-docs.com/storage-objectstorage-listobjectsv2"
---

> ## 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.

# ListObjectsV2

Available in Classic and VPC

View the object list of Object Storage. No request body is used for the operation.

              Note

              

The number of objects retrieved at a time is limited to 1000 and are returned in random order. If the StorageClass operation is not implemented in NAVER Cloud Platform Object Storage, the value of StorageClass returned in the response code is the default value.

## Requests

The following describes the request format for the endpoint. The request format is as follows.

| Method | URI |
| --- | --- |
| GET | {bucket-name} |

### Request syntax

```
GET https://{endpoint}/{bucket-name} # path style
GET https://{bucket-name}.{endpoint} # virtual host style
```

### Request headers

For headers common to all Object Storage APIs, see [Object Storage common headers](/docs/en/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94).

### Request path parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bucket-name` | String | Required | Name of the bucket to create |

### Request query parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `prefix` | String | Optional | Limit the response to object names starting with the prefix |
| `delimiter` | String | Optional | Bind the objects between the prefix and delimiter together |
| `encoding-type` | String | Optional | Encoding type - Resolve encoding issues by setting the parameter to URL if Unicode characters not supported by XML are used in the object name |
| `max-keys` | String | Optional | Number of objects to display in the response - 0 - 1000 (default: 1000) |
| `fetch-owner` | Boolean | Optional | Owner field - `true` \| `false` - `true`: It returns the owner field - By default, it doesn't exist for version 2 methods |
| `start-after` | String | Optional | Specify objects from place where the list should start, in the UTF-8 binary order |
| `continuation-token` | String | Optional | Enable the next list of objects to be retrieved by token |

### Request example

The following is a sample request.

```
GET /{bucket-name}?list-type=2 HTTP/1.1
Content-Type: text/plain
Host: kr.object.ncloudstorage.com
X-Amz-Date: {Timestamp}
Authorization: {authorization-string}
```

## Responses

The following describes the response format.

### Response headers

For response headers common to all Object Storage APIs, see [Object Storage common response headers](/docs/en/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94).

### Response status codes

For response status codes common to all Object Storage APIs, see [Object Storage response status codes](/docs/en/storage-objectstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C).

### Response example

The following is a sample response.

```
HTTP/1.1 200 OK
Date: Wed, 24 Aug 2016 17:45:25 GMT
Accept-Ranges: bytes
x-amz-request-id: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
Content-Type: application/xml
Content-Length: 909
```

```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Name>ncpdocker</Name>
    <Prefix></Prefix>
    <NextContinuationToken>1a8jKPiaWXb4OhJOLGR9KE495oNwIO1KbsTYDLDvtMArEbHtv8h-NKvDagEgx5nJYDx3X4G7r2bDBBMsD9bZN88ECyHcMDZI_HuE-kq5RiM9I_v2ocKx5h7K9QBXV_0NUCWj0EGYwoBOxyJUyhrrbTRN3swqI9xgmavCCZ2IziP8</NextContinuationToken>
    <KeyCount>2</KeyCount>
    <MaxKeys>10</MaxKeys>
    <Delimiter>/</Delimiter>
    <IsTruncated>false</IsTruncated>
    <Contents>
        <Key>ncpdocker.txt</Key>
        <LastModified>2024-04-02T00:57:49.695Z</LastModified>
        <ETag>&quot;xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&quot;</ETag>
        <Size>12</Size>
        <StorageClass>Standard</StorageClass>
    </Contents>
</ListBucketResult>
```