> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snakream.tonbo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get bucket

> Retrieve metadata for a bucket.

<ParamField path="bucket" type="string" required>
  Bucket ID. Must match `[a-z0-9_-]{4,64}`.
</ParamField>

## Response

| Status | Meaning            |
| ------ | ------------------ |
| `200`  | Bucket found.      |
| `400`  | Invalid bucket ID. |
| `404`  | Bucket not found.  |

<ResponseField name="bucket_id" type="string" required>
  The bucket identifier.
</ResponseField>

<ResponseField name="streams" type="number" required>
  Number of streams in the bucket.
</ResponseField>

<RequestExample>
  ```bash Example theme={null}
  curl https://stream.tonbo.dev/ds/demo
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "bucket_id": "demo",
    "streams": 3
  }
  ```
</ResponseExample>