# ListObjects/ListObjectsV2 Returns a list of objects in a bucket. When issuing, pagination is used; in one request, you can get a list of no longer than 1000 objects. If there are more objects, then it is necessary to execute several queries in a row. **Note** This method has two versions. * `listObjectsV2` - up-to-date version, more convenient to use. * `listObjectsV1` - previous version. To call both methods, the same is used `URL`, but it differs in the query parameter. To invoke `listObjectsV2`, use the parameter `list-type=2`. ### listObjectsV2 #### Request ``` GET /{bucket}?list-type=2&continuation-token=ContinuationToken&delimiter=Delimiter&encoding-type=EncodingType&max-keys=MaxKeys&prefix=Prefix&start-after=StartAfter HTTP/1.1 ``` **Path parameters** | Parameter | Description | | --------- | ------------ | | `bucket` | Bucket name. | **Query parameters** All parameters listed in the table are optional. | Parameter | Description | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `continuation-token` |

Used to get the next part of the list if all the results do not fit into one answer.
To get the next part of the list, use the value NextContinuationTokenfrom the previous answer.

| | `delimiter` |

Separator character.

If specified, Object Storage treats the key as a file path, where directories are separated by a character delimiter. In response to the request, the user will see a list of files and directories in the bucket. Files will be displayed in items Contents, and directories in items CommonPrefixes.

If a parameter is also specified in the request prefix, then Object Storage will return a list of files and directories in the directory prefix .

| | `encoding-type` |

Server response encoding.

Object Storage, at the request of the client, can encode the response in the required form.

Possible values: url.

| | `max-keys` |

The maximum number of items in a response.

By default, Object Storage yields no more than 1000 items Contentsand CommonPrefixes. This parameter should be used if you need to get less than 1000 items in one response.

If more keys fall under the selection criteria than fit in the search results, then the answer contains \true\.

To get all the elements of the issue, if there are more of them max-keys, it is necessary to perform several consecutive requests to Object Storage with a parameter continuation-token, where for each request continuation-tokenis equal to the value of the element NextContinuationTokenfrom the previous response.

| | `prefix` |

The string that the key should start with.

Object Storage will only select keys that start with prefix.

It can be used simultaneously with the parameter delimiter. In this case, the output logic is determined by the parameter delimiter.

| | `start-after` | The key to start the listing with. | **Headings** Use only [generic headers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/common-request-headers) in your request . #### Response **Headings** The response can only contain [general headers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/common-response-headers) . **Response codes** For a list of possible answers, see the [Answers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/answers) section . The successful response contains additional data in XML format, the schema of which is described below. **Data schema** ```markup boolean string string timestamp integer string ... string string string integer string ... string integer string string string ``` | Element | Description | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `ListBucketResult` | Root element. | | `IsTruncated` |

A flag indicating whether all results were returned in this response.

True- everything. False- Not all.

Path: /ListBucketResult/IsTruncated.

| | `Contents` |

Description of the object.

The response will contain as many elements Contentsas the keys match the request conditions.

Path: /ListBucketResult/Contents.

| | `ETag` |

MD5 hash of the object. Metadata is not included in the hash calculation.

Path: /ListBucketResult/Contents/ETag.

| | `Key` |

Object key.

Path: /ListBucketResult/Contents/Key.

| | `LastModified` |

The date and time the object was last modified.

Path: /ListBucketResult/Contents/LastModified.

| | `Size` |

The size of the object in bytes.

Path: /ListBucketResult/Contents/Size.

| | `StorageClass` |

Object storage class: STANDARDor COLD.

Path: /ListBucketResult/Contents/StorageClass.

| | `Name` |

Bucket name.

Path: /ListBucketResult/Name.

| | `Prefix` |

The value of the query parameter prefix.

Path: /ListBucketResult/Prefix.

| | `Delimiter` |

The value of the query parameter delimiter.

Path: /ListBucketResult/Delimiter.

| | `MaxKeys` |

The value of the query parameter max-keys.

Path: /ListBucketResult/MaxKeys.

| | `CommonPrefixes` |

The part of the key name that is determined when processing query parameters delimiterand prefix.

Path: /ListBucketResult/CommonPrefixes.

| | `EncodingType` |

The encoding in which Object Storage represents the key in the XML response.

Appears if the client passed a parameter when requested encoding-type.

Path: /ListBucketResult/EncodingType.

| | `KeyCount` |

The number of keys returned by the query.
The number of keys will always be less than or equal MaxKeys.

Path: /ContinuationToken/KeyCount.

| | `ContinuationToken` |

The value of the query parameter continuation-token.

Path: /ContinuationToken/ContinuationToken.

| | `NextContinuationToken` |

The value that must be substituted into the query parameter continuation-tokento get the next part of the list, if the entire list does not fit into the current response.
Refundable only if IsTruncated = true.

Path: /ListBucketResult/NextContinuationToken.

| | `StartAfter` |

The value of the query parameter start-after.

Path: /ListBucketResult/StartAfter.

| ### ListObjects #### Request ``` GET /{bucket}?delimiter=Delimiter&encoding-type=EncodingType&marker=Marker&max-keys=MaxKeys&prefix=Prefix HTTP/1.1 ``` **Path parameters** | Parameter | Description | | --------- | ------------ | | `bucket` | Bucket name. | **Query parameters** All parameters listed in the table are optional. | Parameter | Description | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `delimiter` |

Separator character.

If specified, Object Storage treats the key as a file path, where directories are separated by a character delimiter. In response to the request, the user will see a list of files and directories in the bucket. Files will be displayed in items Contents, and directories in items CommonPrefixes.

If a parameter is also specified in the request prefix, then Object Storage will return a list of files and directories in the directory prefix .

| | `encoding-type` |

Server response encoding.

Object Storage, at the request of the client, can encode the response in the required form.

Possible values: url.

| | `marker` |

The key from which the issuance will begin.

In the resulting output, Object Storage will leave the keys starting from the next one after marker.

| | `max-keys` |

The maximum number of items in a response.

By default, Object Storage yields no more than 1000 items Contentsand CommonPrefixes. This parameter should be used if you need to get less than 1000 items in one response.

If more keys fall under the selection criteria than fit in the search results, then the answer contains \true\.

To get all the elements of the issue, if there are more of them max-keys, it is necessary to perform several consecutive requests to Object Storage with a parameter marker, where for each request markeris equal to the value of the element NextMarkerfrom the previous response.

| | `prefix` |

The string that the key should start with.

Object Storage will only select keys that start with prefix.

It can be used simultaneously with the parameter delimiter. In this case, the output logic is determined by the parameter delimiter.

| **Headings** Use only [generic headers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/common-request-headers) in your request . #### Response **Headings** The response can only contain [general headers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/common-response-headers) . **Response codes** For a list of possible answers, see the [Answers](https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/answers) section . The successful response contains additional data in XML format, the schema of which is described below. **Data schema** ``` boolean string string string string timestamp integer string ... string string string integer string ... string ``` | Element | Description | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `ListBucketResult` | Root element. | | `IsTruncated` |

A flag indicating whether all results were returned in this response.

True- everything. False- Not all.

Path: /ListBucketResult/IsTruncated.

| | `Marker` |

The value of the query parameter marker.

Path: /ListBucketResult/Marker.

| | `NextMarker` |

The value that must be substituted into the query parameter markerto get the next part of the list, if the entire list does not fit into the current response.

Path: /ListBucketResult/NextMarker.

| | `Contents` |

Description of the object.

The response will contain as many elements Contentsas the keys match the request conditions.

Path: /ListBucketResult/Contents.

| | `ETag` |

MD5 hash of the object. Metadata is not included in the hash calculation.

Path: /ListBucketResult/Contents/ETag.

| | `Key` |

Object key.

Path: /ListBucketResult/Contents/Key.

| | `LastModified` |

The date and time the object was last modified.

Path: /ListBucketResult/Contents/LastModified.

| | `Size` |

The size of the object in bytes.

Path: /ListBucketResult/Contents/Size.

| | `StorageClass` |

Object storage class: STANDARDor COLD.

Path: /ListBucketResult/Contents/StorageClass.

| | `Name` |

Bucket name.

Path: /ListBucketResult/Name.

| | `Prefix` |

The value of the query parameter prefix.

Path: /ListBucketResult/Prefix.

| | `Delimiter` |

The value of the query parameter delimiter.

Path: /ListBucketResult/Delimiter.

| | `MaxKeys` |

The value of the query parameter max-keys.

Path: /ListBucketResult/MaxKeys.

| | `CommonPrefixes` |

The part of the key name that is determined when processing query parameters delimiterand prefix.

Path: /ListBucketResult/CommonPrefixes.

| | `EncodingType` |

The encoding in which Object Storage represents the key in the XML response.

Appears if the client passed a parameter when requested encoding-type.

Path: /ListBucketResult/EncodingType.

| --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.coldstack.io/http-api-compatible-with-amazon-s3/api-reference/bucket/listobjects.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.