---
title: "GET /namespaces/{tableBucketARN}"
method: GET
path: "/namespaces/{tableBucketARN}"
---

# GET /namespaces/{tableBucketARN}

`GET /namespaces/{tableBucketARN}`

Lists the namespaces within a table bucket. For more information, see [Table namespaces](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html) in the _Amazon Simple Storage Service User Guide_.

Permissions

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

## Path parameters

- `tableBucketARN` string, required

## Query parameters

- `prefix` string
- `continuationToken` string
- `maxNamespaces` integer

## Response `200`

Success

- ListNamespacesResponse
  - `namespaces` NamespaceSummary[], required — A list of namespaces.
    - `namespace` NamespaceName[], required — The name of the namespace.
    - `createdAt` string, date-time, required — The date and time the namespace was created at.
    - `createdBy` string, required — The ID of the account that created the namespace.
    - `ownerAccountId` string, required — The ID of the account that owns the namespace.
    - `namespaceId` string — The system-assigned unique identifier for the namespace.
    - `tableBucketId` string — The system-assigned unique identifier for the table bucket that contains this namespace.
  - `continuationToken` string — The <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)