---
title: "GET /app-instances/{appInstanceArn}/retention-settings"
method: GET
path: "/app-instances/{appInstanceArn}/retention-settings"
---

# GET /app-instances/{appInstanceArn}/retention-settings

`GET /app-instances/{appInstanceArn}/retention-settings`

Gets the retention settings for an <code>AppInstance</code>.

## Path parameters

- `appInstanceArn` string, required

## Response `200`

Success

- GetAppInstanceRetentionSettingsResponse
  - `AppInstanceRetentionSettings` object — The retention settings for the <code>AppInstance</code>.
    - `ChannelRetentionSettings` object — The length of time in days to retain the messages in a channel.
      - `RetentionDays` integer — The time in days to retain the messages in a channel.
  - `InitiateDeletionTimestamp` string, date-time — The timestamp representing the time at which the specified items are retained, in Epoch Seconds.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — ThrottledClientException
- `483` — UnauthorizedClientException
- `484` — ServiceUnavailableException
- `485` — ServiceFailureException

---

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