---
title: "Look up an S3 bucket name"
method: GET
path: "/storage/s3/bucket"
tags: ["Storage"]
---

# Look up an S3 bucket name

`GET /storage/s3/bucket`

What an unsigned HEAD can tell you about a bucket before anyone has credentials for it: whether the name is taken, and by which region. It cannot say whether the bucket is yours, because S3 names are global. For the connect form, so a name that will not work is answered in the field rather than two minutes later in the AWS console.

## Query parameters

- `name` string, required

## Response `200`

What the name resolves to

- object
  - `data` object, required
    - `state` 'found' | 'free' | 'unknown', required
    - `region` string, nullable, required

## Other responses

- `401` — Unauthorized
- `403` — Missing scope or role

## Changes

- **2026-09-13** `e2df91eff7a2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rendobar/apis/rendobar-api/changes/storage/s3/bucket/get.md)

---

[API](https://skmtc.dev/rendobar/apis/rendobar-api.md) · [All operations](https://skmtc.dev/rendobar/apis/rendobar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rendobar/apis/rendobar-api/revisions/14f92fdd491f?raw)