---
title: "List buckets"
method: GET
path: "/v1/object-storage/buckets"
tags: ["Object Storage"]
---

# List buckets

`GET /v1/object-storage/buckets`

## Request

- Base URL: `https://api.verda.com`
- URL: `https://api.verda.com/v1/object-storage/buckets`
- Auth: HTTP bearer

Returns all buckets for the project.

## Response `200`

List of buckets

- GetBucketResponseDto[]
  - `id` string, required: Unique identifier of the bucket
  - `name` string, required: Globally unique bucket name
  - `object_count` number: Number of objects stored in the bucket
  - `size_gb` number: Total size of all objects in GB
  - `created_at` string, date-time, required: When the bucket was created

## Changes

- **2026-10-13** `8b32d95738b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datacrunch/apis/verda-cloud-public-api/changes/v1/object-storage/buckets/get.md)

---

[API](https://skmtc.dev/datacrunch/apis/verda-cloud-public-api.md) · [All operations](https://skmtc.dev/datacrunch/apis/verda-cloud-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/datacrunch/apis/verda-cloud-public-api/revisions/05b167f797de?raw)