# Retrieve the list of devices an announcement is distributed to

Get the individual Announcement distributed to device

## Endpoint

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

## Request

### Request URL

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

### Scope

`MDMDeviceMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

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

#### Path Parameters

- **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

#### Query Parameters

- **limit** (`integer`, Optional): Maximum number of records to return in a single response. Used together with offset for pagination
- **skip-token** (`string`, Optional): Pagination continuation token returned by a previous response. Pass it to fetch the next page of results
- **offset** (`integer`, Optional): Zero-based index of the first record to return. Used together with limit for pagination
- **delta-token** (`string`, Optional): Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point

### Sample Request

```curl
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/announcements/{announcement_id}/devices?limit=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE&offset=SOME_INTEGER_VALUE&delta-token=SOME_STRING_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response body: `application/json`

- `JSON Object`
  - **metadata** (`JSON Object`): Pagination metadata with total record count
  - **devices** (`JSON Array`): Array of device objects the announcement is distributed to

### Possible Response Codes

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

### Sample Response: HTTP 200

List of devices the announcement is distributed to with metadata:

```json
{
  "metadata": {
    "total_record_count": "1"
  },
  "devices": [
    {
      "platform_type": "2",
      "name": "admin_SM-S921B",
      "resource_id": "9007199254741895",
      "udid": "96d096245821a479"
    }
  ]
}
```

Announcement is not distributed to any devices:

```json
{
  "metadata": {
    "total_record_count": "0"
  },
  "devices": []
}
```

## 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.