---
title: "GET /table-record-expiration#tableArn"
method: GET
path: "/table-record-expiration#tableArn"
---

# GET /table-record-expiration#tableArn

`GET /table-record-expiration#tableArn`

Retrieves the expiration configuration settings for records in a table, and the status of the configuration. If the status of the configuration is `enabled`, records expire and are automatically removed from the table after the specified number of days.

Permissions

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

## Query parameters

- `tableArn` string, required

## Response `200`

Success

- GetTableRecordExpirationConfigurationResponse
  - `configuration` object, required — The record expiration configuration for the table, including the status and retention settings.
    - `status` 'enabled' | 'disabled' — The status of the expiration settings for records in the table.
    - `settings` object — The expiration settings for records in the table.
      - `days` integer — If you enable record expiration for a table, you can specify the number of days to retain your table records. For example, to retain your table records for one year, set this value to <code>365</code>.

## Other responses

- `480` — InternalServerErrorException
- `481` — MethodNotAllowedException
- `482` — ForbiddenException
- `483` — NotFoundException
- `484` — TooManyRequestsException
- `485` — 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)