---
title: "List Buckets"
method: GET
path: "/v3/buckets"
tags: ["Buckets"]
---

# List Buckets

`GET /v3/buckets`

## Query parameters

- `limit` integer
- `startingAfter` string
- `endingBefore` string
- `nameSubstring` string

## Response `200`

The request has succeeded.

- BucketListResponseV3 — Response body for listing buckets.
  - `buckets` BucketV3[], required
    - `bucketID` string, required — Stable public identifier for the bucket (`bkt_...`).
    - `name` string, required — Human-facing bucket name. Unique within an account+environment.
    - `description` string, required — Optional human-facing note about the bucket.
    - `isDefault` boolean, required — Whether this is the account+environment's default bucket.
    - `createdAt` string, date-time, required — Creation timestamp (RFC 3339).
    - `updatedAt` string, date-time, required — Last-update timestamp (RFC 3339).
  - `totalCount` integer, required — Total number of buckets matching the query, ignoring pagination.

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)