---
title: "Get retention period"
method: GET
path: "/wiki/rest/api/audit/retention"
tags: ["Audit"]
---

# Get retention period

`GET /wiki/rest/api/audit/retention`

Returns the retention period for records in the audit log. The retention
period is how long an audit record is kept for, from creation date until
it is deleted.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
'Confluence Administrator' global permission.

## Response `200`

Returned if the requested retention period is returned.

- RetentionPeriod
  - `number` integer, required — The number of units for the retention period.
  - `units` 'NANOS' | 'MICROS' | 'MILLIS' | 'SECONDS' | 'MINUTES' | 'HOURS' | 'HALF_DAYS' | 'DAYS' | 'WEEKS' | 'MONTHS' | 'YEARS' | 'DECADES' | 'CENTURIES' | 'MILLENNIA' | 'ERAS' | 'FOREVER', required — The unit of time that the retention period is measured in.

## Other responses

- `403` — Returned if the calling user does not have permission to view the audit log.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)