---
title: "List all Buckets"
method: GET
path: "/api/v1/buckets"
tags: ["Bucket"]
---

# List all Buckets

`GET /api/v1/buckets`

List all Bucket

## Response `200`

successful operation

- ListBucket
  - `status` string
  - `buckets` Bucket[]
    - `id` string
    - `name` string
    - `plan` string
    - `status` string
    - `permission` string
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `401` — Missing authentication
- `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/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)