# Retrieve detailed information about a specific announcement

Get the individual Announcement details.

## Endpoints

`GET /api/v1/mdm/announcements/{announcement_id}`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/announcements/{announcement_id}`

### Scope

`MDMDeviceMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Parameter | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/json` |

### Path Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| announcement_id | string | Mandatory | Unique identifier of the announcement. Obtain from the [Create Announcement](https://www.manageengine.com/products/desktop-central/help/api/onpremise/announcements-create-announcement.html) or [Get Announcements](https://www.manageengine.com/products/desktop-central/help/api/onpremise/announcements-get-announcements.html) response |

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/v1/mdm/announcements/{announcement_id} \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body: `application/json`

| Attribute | Type | Description |
|---|---|---|
| announcement_id | long | Unique ID representing the announcement |
| announcement_name | string | Name/title of the announcement |
| announcement_format | integer | Display format code for the announcement |
| creation_time | string | Epoch timestamp (milliseconds) when the announcement was created |
| last_modified_time | string | Epoch timestamp (milliseconds) when the announcement was last modified |
| created_by_user | string | Username of the admin who created the announcement |
| last_modified_by_user | string | Username of the admin who last modified the announcement |
| collection_id | string | Internal collection ID associated with this announcement |
| profile_id | string | Internal profile ID associated with this announcement |
| ack_button | string | Acknowledgement button text shown on device. Empty string if acknowledgement not required |
| needs_acknowledgement | boolean | Whether the announcement requires acknowledgement from the device user |
| is_moved_to_trash | boolean | Whether the announcement has been soft-deleted |
| no_of_devices_distributed | string | Number of devices the announcement is distributed to |
| no_of_groups_distributed | string | Number of groups the announcement is distributed to |
| announcement_detail | JSON Object | Nested object containing full announcement message content details including acknowledgement settings |

### Sample Response: HTTP 200

Announcement details with distribution counts:

```json
{
  "creation_time": "1603910052300",
  "last_modified_time": "1603910052252",
  "announcement_name": "test1",
  "announcement_format": 1,
  "needs_acknowledgement": false,
  "last_modified_by_user": "admin",
  "no_of_devices_distributed": "0",
  "created_by_user": "admin",
  "no_of_groups_distributed": "0",
  "collection_id": "9007199254741137",
  "ack_button": "",
  "is_moved_to_trash": false,
  "profile_id": "9007199254740995",
  "announcement_id": 9007199254740996,
  "announcement_detail": {
    "ack_button": "",
    "nbar_message": "",
    "title_color": "#ffffff",
    "nbar_icon": "/images/announcement/nbaricon/info.png",
    "announcement_img_id": "9007199254740995",
    "needs_acknowledgement": "false",
    "detail_message": "Sample announcement content",
    "title": "test1"
  }
}
```

Announcement with acknowledgement enabled and active distribution:

```json
{
  "creation_time": "1679500000000",
  "last_modified_time": "1679600000000",
  "announcement_name": "Policy Update",
  "announcement_format": 1,
  "needs_acknowledgement": true,
  "last_modified_by_user": "admin",
  "no_of_devices_distributed": "15",
  "created_by_user": "admin",
  "no_of_groups_distributed": "3",
  "collection_id": "9007199254741200",
  "ack_button": "Got It",
  "is_moved_to_trash": false,
  "profile_id": "9007199254740996",
  "announcement_id": 9007199254740996,
  "announcement_detail": {
    "ack_button": "Got It",
    "nbar_message": "Important policy update",
    "title_color": "#ff5722",
    "nbar_icon": "/images/announcement/nbaricon/info.png",
    "announcement_img_id": "9007199254740996",
    "needs_acknowledgement": "true",
    "detail_message": "<p>Please review the updated company policy</p>",
    "title": "Policy Update"
  }
}
```

## Possible Response Codes

| Code | Type |
|---|---|
| 200 | HTTP code |

## Rate Limit

**Duration:** 1 minute | **Threshold:** 120 | **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.