---
title: "Get a Bucket"
method: GET
path: "/v3/buckets/{bucketID}"
tags: ["Buckets"]
---

# Get a Bucket

`GET /v3/buckets/{bucketID}`

## Path parameters

- `bucketID` string, required

## Response `200`

The request has succeeded.

- BucketV3 — A Bucket is a named partition of the knowledge graph within an account+environment. Entities, mentions, and relations are scoped to a bucket so a single account+environment can host multiple isolated graphs. Every account+environment has exactly one default bucket. The default bucket can be renamed but never deleted.
  - `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).

## Changes

> 42 revisions in range; 1 could not be searched.

- **2026-06-17** `d7092283f192` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bem-team/apis/bem-api/changes/v3/buckets/:bucketID/get.md)

---

[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)