Get the Announcement details list
https://{server-hostname}:8383/api/v1/mdm/announcements
MDMDeviceMgmt.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
Maximum number of records to return in a single response. Used together with offset for pagination
Pagination continuation token returned by a previous response. Pass it to fetch the next page of results
Zero-based index of the first record to return. Used together with limit for pagination
Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point
curl --request GET \
--url 'https://appdomain/api/v1/mdm/announcements?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'Array of announcement objects
Unique ID representing the announcement
Name/title of the announcement
Display format code determining how the announcement is rendered on device
Epoch timestamp (milliseconds) when the announcement was created
Epoch timestamp (milliseconds) when the announcement was last modified
Username of the admin who created the announcement
Username of the admin who last modified the announcement
Internal collection ID associated with this announcement
Internal profile ID associated with this announcement
Acknowledgement button text shown on device. Empty string if acknowledgement not required
Whether the announcement requires acknowledgement from the device user
Whether the announcement has been soft-deleted (moved to trash)
Nested object containing announcement message content details
Title of the announcement
Hex color code for the title text (e.g., #ffffff)
Path to the notification bar icon image
Short message displayed in the device notification bar
Full HTML message content displayed in the app
Image ID for the notification bar image
List of all announcements with metadata and detail content
{
"announcement": [
{
"creation_time": "1603910052300",
"last_modified_time": "1603910052252",
"announcement_name": "test1",
"announcement_format": 1,
"needs_acknowledgement": false,
"last_modified_by_user": "admin",
"created_by_user": "admin",
"collection_id": "9007199254741137",
"ack_button": "",
"is_moved_to_trash": false,
"profile_id": "9007199254740995",
"announcement_id": 9007199254740996,
"announcement_detail": {
"nbar_message": "",
"title_color": "#ffffff",
"nbar_icon": "/images/announcement/nbaricon/info.png",
"announcement_img_id": "9007199254740995",
"detail_message": "Sample announcement message content",
"title": "test1"
}
}
]
}
No announcements found
{
"announcement": []
}
![]()
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.