GET api/v2.0/Announcements/GetAnnouncements?announcementTypeFilter={announcementTypeFilter}&communityKey={communityKey}&micrositeGroupTypeRouteDesignKey={micrositeGroupTypeRouteDesignKey}&sortOrder={sortOrder}&maxResults={maxResults}&includeAnnouncementsWithNoType={includeAnnouncementsWithNoType}

Returns a list of Announcements given the specified criteria.

Request Information

URI Parameters

Name	Description	Type	Additional information
announcementTypeFilter	Comma-separated list of AnnouncementTypes to return. Optional: Returns all if none specified.	string	Default value is
communityKey	Filters results by a specific CommunityKey Guid. Optional: Returns all if none specified.	string	Default value is
micrositeGroupTypeRouteDesignKey	Filters results by a specific micrositeGroupTypeRouteDesignKey. Optional: Returns all if none specified.	string	Default value is
sortOrder	Specify SQL-style sort order in a comma-separated string. Optional: Defaults to CreatedOn Date, in descending order if none specified.	string	Default value is
maxResults	The maximum results to return. Optional: Defaults to 100 if not specified.	integer	Default value is 100
includeAnnouncementsWithNoType	If Set to true; returns announcements with no AnnouncementType set. If set to false; returns only announcements specified in the 'announcementTypeFilter' parameter.	boolean	Default value is True

Body Parameters

None.

Response Information

Resource Description

List of Announcements.

Collection of Announcement

Name	Type	Additional information
AnnouncementKey	globally unique identifier	None.
AnnouncementText	string	None.
AnnouncementTitle	string	None.
AnnouncementType	string	None.
CommunityKey	globally unique identifier	None.
CreatedByContactKey	globally unique identifier	None.
ContactDisplayName	string	None.
LinkToContactProfile	string	None.
ContactLargePictureUrl	string	None.
ContactSmallPictureUrl	string	None.
CreatedOn	date	None.
IsLoggingEnabled	boolean	None.
LinkText	string	None.
LinkUrl	string	None.
MicrositeGroupTypeRouteDesignKey	globally unique identifier	None.
OpenNewWindow	boolean	None.
UpdatedByContactKey	globally unique identifier	None.
UpdatedOn	date	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "AnnouncementKey": "e55ec7f8-38d7-4d74-a8f8-38d04f2ca352",
    "AnnouncementText": "sample string 2",
    "AnnouncementTitle": "sample string 3",
    "AnnouncementType": "sample string 4",
    "CommunityKey": "09e5e64d-de2f-4106-a4c8-7e9de8e7d92b",
    "CreatedByContactKey": "ea13d7a6-3d05-4778-9bc1-7edfab7c93e7",
    "ContactDisplayName": "sample string 7",
    "LinkToContactProfile": "sample string 8",
    "ContactLargePictureUrl": "sample string 9",
    "ContactSmallPictureUrl": "sample string 10",
    "CreatedOn": "2020-02-21T18:50:15.7216937Z",
    "IsLoggingEnabled": true,
    "LinkText": "sample string 13",
    "LinkUrl": "sample string 14",
    "MicrositeGroupTypeRouteDesignKey": "afb2a46b-6655-4bba-b36c-927adac3adcf",
    "OpenNewWindow": true,
    "UpdatedByContactKey": "c2eef65f-29d2-4f6c-97dc-c5ed85e5a24b",
    "UpdatedOn": "2020-02-21T18:50:15.7216937Z"
  },
  {
    "AnnouncementKey": "e55ec7f8-38d7-4d74-a8f8-38d04f2ca352",
    "AnnouncementText": "sample string 2",
    "AnnouncementTitle": "sample string 3",
    "AnnouncementType": "sample string 4",
    "CommunityKey": "09e5e64d-de2f-4106-a4c8-7e9de8e7d92b",
    "CreatedByContactKey": "ea13d7a6-3d05-4778-9bc1-7edfab7c93e7",
    "ContactDisplayName": "sample string 7",
    "LinkToContactProfile": "sample string 8",
    "ContactLargePictureUrl": "sample string 9",
    "ContactSmallPictureUrl": "sample string 10",
    "CreatedOn": "2020-02-21T18:50:15.7216937Z",
    "IsLoggingEnabled": true,
    "LinkText": "sample string 13",
    "LinkUrl": "sample string 14",
    "MicrositeGroupTypeRouteDesignKey": "afb2a46b-6655-4bba-b36c-927adac3adcf",
    "OpenNewWindow": true,
    "UpdatedByContactKey": "c2eef65f-29d2-4f6c-97dc-c5ed85e5a24b",
    "UpdatedOn": "2020-02-21T18:50:15.7216937Z"
  }
]

application/xml, text/xml

Sample:

<ArrayOfAnnouncement xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
  <Announcement>
    <AnnouncementKey>e55ec7f8-38d7-4d74-a8f8-38d04f2ca352</AnnouncementKey>
    <AnnouncementText>sample string 2</AnnouncementText>
    <AnnouncementTitle>sample string 3</AnnouncementTitle>
    <AnnouncementType>sample string 4</AnnouncementType>
    <CommunityKey>09e5e64d-de2f-4106-a4c8-7e9de8e7d92b</CommunityKey>
    <ContactDisplayName>sample string 7</ContactDisplayName>
    <ContactLargePictureUrl>sample string 9</ContactLargePictureUrl>
    <ContactSmallPictureUrl>sample string 10</ContactSmallPictureUrl>
    <CreatedByContactKey>ea13d7a6-3d05-4778-9bc1-7edfab7c93e7</CreatedByContactKey>
    <CreatedOn>2020-02-21T13:50:15.7216937-05:00</CreatedOn>
    <IsLoggingEnabled>true</IsLoggingEnabled>
    <LinkText>sample string 13</LinkText>
    <LinkToContactProfile>sample string 8</LinkToContactProfile>
    <LinkUrl>sample string 14</LinkUrl>
    <MicrositeGroupTypeRouteDesignKey>afb2a46b-6655-4bba-b36c-927adac3adcf</MicrositeGroupTypeRouteDesignKey>
    <OpenNewWindow>true</OpenNewWindow>
    <UpdatedByContactKey>c2eef65f-29d2-4f6c-97dc-c5ed85e5a24b</UpdatedByContactKey>
    <UpdatedOn>2020-02-21T13:50:15.7216937-05:00</UpdatedOn>
  </Announcement>
  <Announcement>
    <AnnouncementKey>e55ec7f8-38d7-4d74-a8f8-38d04f2ca352</AnnouncementKey>
    <AnnouncementText>sample string 2</AnnouncementText>
    <AnnouncementTitle>sample string 3</AnnouncementTitle>
    <AnnouncementType>sample string 4</AnnouncementType>
    <CommunityKey>09e5e64d-de2f-4106-a4c8-7e9de8e7d92b</CommunityKey>
    <ContactDisplayName>sample string 7</ContactDisplayName>
    <ContactLargePictureUrl>sample string 9</ContactLargePictureUrl>
    <ContactSmallPictureUrl>sample string 10</ContactSmallPictureUrl>
    <CreatedByContactKey>ea13d7a6-3d05-4778-9bc1-7edfab7c93e7</CreatedByContactKey>
    <CreatedOn>2020-02-21T13:50:15.7216937-05:00</CreatedOn>
    <IsLoggingEnabled>true</IsLoggingEnabled>
    <LinkText>sample string 13</LinkText>
    <LinkToContactProfile>sample string 8</LinkToContactProfile>
    <LinkUrl>sample string 14</LinkUrl>
    <MicrositeGroupTypeRouteDesignKey>afb2a46b-6655-4bba-b36c-927adac3adcf</MicrositeGroupTypeRouteDesignKey>
    <OpenNewWindow>true</OpenNewWindow>
    <UpdatedByContactKey>c2eef65f-29d2-4f6c-97dc-c5ed85e5a24b</UpdatedByContactKey>
    <UpdatedOn>2020-02-21T13:50:15.7216937-05:00</UpdatedOn>
  </Announcement>
</ArrayOfAnnouncement>