---
descriptions:
  get_retention:
    retention_period_in_days: The number of days Audit Log events will be retained.
reference:
  curl:
    - key: get_retention
      id: get_retention
      url: /reference/audit-logs/get-retention
      title: '/organizations/:id/audit_logs_retention'
      type: GET
      parameters:
        - key: id
          type: string
          description: (organization.id)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: retention_period_in_days
              type: number
              description: (get_retention.retention_period_in_days)
originalPath: .tmp-workos-clone/packages/docs/content/reference/audit-logs/retention/get.mdx
---

## Get Retention

Get the configured event retention period for the given Organization.

<CodeBlock referenceId="get_retention">
  <CodeBlockTab title="Request" file="get-retention-request" />
  <CodeBlockTab title="Response" file="get-retention-response" />
</CodeBlock>