---
title: "GET /get-table"
method: GET
path: "/get-table"
---

# GET /get-table

`GET /get-table`

Gets details about a table. For more information, see [S3 Tables](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html) in the _Amazon Simple Storage Service User Guide_.

Permissions

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

## Query parameters

- `tableBucketARN` string
- `namespace` string
- `name` string
- `tableArn` string

## Response `200`

Success

- GetTableResponse
  - `name` string, required — The name of the table.
  - `type` 'customer' | 'aws', required — The type of the table.
  - `tableARN` string, required — The Amazon Resource Name (ARN) of the table.
  - `namespace` NamespaceName[], required — The namespace associated with the table.
  - `namespaceId` string — The unique identifier of the namespace containing this table.
  - `versionToken` string, required — The version token of the table.
  - `metadataLocation` string — The metadata location of the table.
  - `warehouseLocation` string, required — The warehouse location of the table.
  - `createdAt` string, date-time, required — The date and time the table bucket was created at.
  - `createdBy` string, required — The ID of the account that created the table.
  - `managedByService` string — The service that manages the table.
  - `modifiedAt` string, date-time, required — The date and time the table was last modified on.
  - `modifiedBy` string, required — The ID of the account that last modified the table.
  - `ownerAccountId` string, required — The ID of the account that owns the table.
  - `format` 'ICEBERG', required — The format of the table.
  - `tableBucketId` string — The unique identifier of the table bucket containing this table.
  - `managedTableInformation` object — If this table is managed by S3 Tables, contains additional information such as replication details.
    - `replicationInformation` object — If this table is a replica, contains information about the source table from which it is replicated.
      - `sourceTableARN` string, required — The Amazon Resource Name (ARN) of the source table from which this table is replicated.

## 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)