# Retrieves the complete configuration details of the specified announcement

Returns the full configuration details of the specified announcement, including the message content, schedule (start time, end time, lap time), deployment targets, and current status.

## Endpoints

`GET /dcapi/tools/announcement/{collectionId}`

## Request

### Request URL

`https://{server-hostname}:8383/dcapi/tools/announcement/{collectionId}`

### Scope

`Tools.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** (`string`, Mandatory): `application/json`

#### Path Parameters

- **collectionId** (`string`, Mandatory): The unique identifier of the system tools collection

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/tools/announcement/{collectionId} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response body: `application/json`

- **JSON Object**
  - **collectionId** (`long`): Announcement collection unique identifier
  - **label** (`string`): Announcement display label
  - **status** (`string`): Deployment status
  - **configType** (`string`): Target scope: Computer or User
  - **targetDetails** (`JSON Object`): Target configuration with targetType, targetValue, and envType
  - **configDetails** (`array`): Array containing announcement toolDetails with message, schedule, and timing

### Possible Response Codes

- **200** (`HTTP code`)

### Sample Response: HTTP 200

```json
{
  "configDetails": [
    {
      "toolDetails": {
        "repeatFrequency": 1,
        "repeatDuration": 600,
        "startTime": "22:00",
        "endTime": "02:00",
        "message": "System maintenance scheduled tonight from 11 PM to 2 AM."
      }
    }
  ],
  "label": "Maintenance Window Notice",
  "configType": "Computer",
  "collectionId": 7,
  "targetDetails": {
    "envType": 0,
    "targetValue": "Engineering",
    "targetType": "CustomGroup"
  },
  "status": "Active"
}
```

## Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.