---
title: "List Objects"
method: GET
path: "/api/v1/buckets/{bucket}/objects/{prefix}"
tags: ["Object"]
---

# List Objects

`GET /api/v1/buckets/{bucket}/objects/{prefix}`

Return list of objects ( max:50, min:1 )

## Path parameters

- `bucket` string, required
- `prefix` string, required

## Query parameters

- `number` string
- `page` string

## Response `200`

successful operation

- Objects
  - `status` string
  - `data` object
    - `objects` object
      - `IsTruncated` boolean
      - `Contents` object[]
        - `Key` string
        - `LastModified` string
        - `ETag` string
        - `ChecksumAlgorithm` object[]
        - `Size` number
        - `StorageClass` string
      - `Name` string
      - `Prefix` string
      - `Delimiter` string
      - `MaxKeys` number
      - `CommonPrefixes` object[]
        - `Prefix` string
      - `KeyCount` number

## Other responses

- `400` — Bad Request
- `401` — Missing authentication
- `404` — Not Found
- `409` — Conflict
- `500` — server does not response

## Changes

- **2023-10-06** `e80fa6480d76` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2023-10-04** `aa2c8187a376` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/liara-cloud/apis/object-storage-api-documentaion/changes/api/v1/buckets/:bucket/objects/:prefix/get.md)

---

[API](https://skmtc.dev/liara-cloud/apis/object-storage-api-documentaion.md) · [All operations](https://skmtc.dev/liara-cloud/apis/object-storage-api-documentaion/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liara-cloud/object-storage-api-documentaion/revisions/b0ca12d806de/schema)