# GetChangeDataRetentionBarrier

## General

### Description

Returns the date of the earliest partition retention barrier when multiple partition retention barriers have been set.

When different retention barriers have been set by multiple consuming applications, Replicate will delete old Change Data partitions up to the earliest partition retention barrier.

For information on setting a partition retention barrier, see [SetChangeDataRetentionBarrier](https://help.qlik.com/en-US/enterprise-manager/November2025/Content/EnterpriseManager/EnterpriseManager_APIGuide/CurlAPI/api_SetChangeDataRetentionBarrier.htm).

### URL

https://{host:port}/attunityenterprisemanager/api/v1/servers/{server}/tasks/ {task}?action=get\_change\_data\_retention\_barrier

### HTTP method

GET

### Required user role

See [Required Enterprise Manager permissions](https://help.qlik.com/en-US/enterprise-manager/November2025/Content/EnterpriseManager/EnterpriseManager_APIGuide/Introduction/AEMPermissions.htm).

## Request parameters

Request parameters

| Location | Name | Required | Description/Example |
| --- | --- | --- | --- |
| URL | host [string] | Yes | The host name of the Enterprise Manager machine.<br><br>Example:<br><br>computer.network.net |
| URL | server [string] | Yes | The Replicate server name, as defined in Enterprise Manager.<br><br>Example:<br><br>myrepsrv1 |
| URL | task [string] | Yes | The Replicate task name.<br><br>Example:<br><br>TargetAWSEMR |

## Response body

Response parameters

| Name | Type | Description |
| --- | --- | --- |
| application | string | The name of the consuming application that set the earliest partition retention barrier. |
| retention\_point | datetime<br><br>Format: yyyy'-'MM'-'dd'T'HH':'mm':'ss'Z' | The date of the earliest partition retention barrier. |

## cURL example

GET attunityenterprisemanager/api/v1/servers/roni-2012/tasks/Oracle2NULL?action=get\_change\_data\_retention\_barrier

Response:

{"application":"xxx","retention\_point":"2020-06-30T16:15:00Z"}

## Error response

Error responses

| HTTP Code | Enterprise Manager Code | Text | Description |
| --- | --- | --- | --- |
| 500 | AEM\_TASK\_NOT\_FOUND | Replication task {task] on server {server} could not be found. | Returned when an unknown task name is encountered. |