---
title: "GET /buckets"
method: GET
path: "/buckets"
---

# GET /buckets

`GET /buckets`

Lists table buckets for your account. For more information, see [S3 Table buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets.html) in the _Amazon Simple Storage Service User Guide_.

Permissions

You must have the `s3tables:ListTableBuckets` permission to use this operation.

## Query parameters

- `prefix` string
- `continuationToken` string
- `maxBuckets` integer
- `type` 'customer' | 'aws'

## Response `200`

Success

- ListTableBucketsResponse
  - `tableBuckets` TableBucketSummary[], required — A list of table buckets.
    - `arn` string, required — The Amazon Resource Name (ARN) of the table bucket.
    - `name` string, required — The name of the table bucket.
    - `ownerAccountId` string, required — The ID of the account that owns the table bucket.
    - `createdAt` string, date-time, required — The date and time the table bucket was created at.
    - `tableBucketId` string — The system-assigned unique identifier for the table bucket.
    - `type` 'customer' | 'aws' — The type of the table bucket.
  - `continuationToken` string — You can use this <code>ContinuationToken</code> for pagination of the list results.

## Other responses

- `480` — InternalServerErrorException
- `481` — ForbiddenException
- `482` — NotFoundException
- `483` — AccessDeniedException
- `484` — TooManyRequestsException
- `485` — ConflictException
- `486` — BadRequestException

---

[API](https://skmtc.net/aws/apis/s3tables.md) · [All operations](https://skmtc.net/aws/apis/s3tables/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/s3tables/versions/d7413f19d46e/schema)