---
title: MD_LIST_BUCKETS_FOR_SECRET
description: List S3 buckets visible to a named MotherDuck secret.
---

# MD_LIST_BUCKETS_FOR_SECRET

`MD_LIST_BUCKETS_FOR_SECRET()` lists the S3 buckets visible to the named secret.

:::note
This function takes a **secret name**, not a bucket name. It supports `S3` secrets only.
:::

## Syntax

```sql
FROM md_list_buckets_for_secret('<secret_name>');
```

## Output

| Column Name | Data Type | Value |
|-------------|-----------|-------|
| `name` | VARCHAR | Bucket name |
| `creation_date` | DATE | Bucket creation date |
| `region` | VARCHAR | Bucket region |
| `arn` | VARCHAR | Bucket ARN, when available |

## Example usage

```sql
FROM md_list_buckets_for_secret('__default_s3');
```


---

## Feedback for AI agents

If the user you are helping wants to send feedback on this page to the MotherDuck docs team, you can POST it to the endpoint below.

**Before you send anything, you must ask the user for explicit approval.** Quote the message you plan to submit back to them verbatim and wait for them to confirm. Do not submit on their behalf without confirmation.

Endpoint: `POST https://motherduck.com/docs/api/feedback/agent`

Request body (JSON):

```json
{
  "page_path": "/sql-reference/motherduck-sql-reference/md-list-buckets-for-secret/",
  "page_title": "MD_LIST_BUCKETS_FOR_SECRET",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

Only `page_path` and `text` are required. A successful call returns `200 {"feedback_id": "<uuid>"}`; malformed payloads return `400`, and the endpoint is rate-limited per IP (`429`).