List Contact Filters

get https://api.everbridge.net/rest/contactFilters/{organizationId}

Retrieve all contact filters for an organization

Contact Filter Fields

Field	Data Type (Length)	Required?	Read Only	Notes
id	long	n	x	The internal ID for a contact filter. It is visible on the URI in the UI.
name	string (100)	y		The name of the filter.
contactFilterType	string	n		Constant ContactRule.
contactFilterRules	contactFilterRule[]	y		An array of contactFilterrules.
createdDate	long	n	x	Unix epoch date/time when the filter was created.
createdId	long	n	x	Internal ID of the user that created this filter.
createdName	string	n	x	First and last name of the user that created this filter.
lastModifiedDate	long	n	x	Unix epoch date/time when the filter was last modified.
lastModifiedId	long	n	x	The internal ID of the user that last modified this filter.
lastModifiedName	string	n	x	The first and last name of the user that last modified this filter.
lastModifiedTime	long	n	x	Unix epoch date/time when the filter was last modified.
lastSynchronizedTime	long	n	x	Unix epoch date/time when the filter was last synchronized.
accountId	long	n	x	The ID of the account that owns this resource.
status	string	n	x	The status of the object. All records returned by the API should have a status of 'A' indicating that the record is active and has not been deleted. Deleted records of any type are invisible to the API.
resourceBundleId	long	n	x	The ID of the Role which owns this resource.
organizationId	long	n	x	The ID of the organization to which this filter belongs.
dirty	boolean	n	x	Whether the contacts of this group have been updated and need to refresh map layer data.

Contact Filter Rule Fields

Name	Data Type (Length)	Required?	Description
id	long	x	The internal ID for a contact.
contactFieldId	long		Required if type is SYSTEM, SYSTEM_OBJECT or SYSTEM_ARRAY
columnName	string		Required if type is SYSTEM, SYSTEM_OBJECT or SYSTEM_ARRAY
columnValue	Depends on field type (string, date, number)		Required if type is SYSTEM, SYSTEM_OBJECT or SYSTEM_ARRAY
attributeId	long		Required if type is CUSTOM or CUSTOM_ARRAY
attributeValues	string[]		The values the filter is looking for. Required if type is CUSTOM or CUSTOM_ARRAY
type	string		One of: ◊ SYSTEM ◊ CUSTOM ◊ SYSTEM_OBJECT ◊ SYSTEM_ARRAY ◊ CUSTOM_ARRAY ◊ SYSTEM_SCHEDULING ◊ SYSTEM_EXPECTED_OBJECT ◊ SYSTEM_TRAVEL_SEGMENT_OBJECT
dataType	string		One of: ◊ STRING ◊ NUMBER ◊ DATE ◊ BOOLEAN
operator	string		String ◊ STARTWITH ◊ ENDWITH (ends with) ◊ E (equal to) ◊ NE (not equal to) ◊ LIKE (contains) ◊ NLIKE (does not contain) ◊ GT (greater than) ◊ LT (less than) ◊ GTE (greater than or equal to) ◊ LTE (less than or equal to) Number ◊ E (equal to) ◊ NE (not equal to) ◊ GT (greater than) ◊ LT (less than) ◊ GTE (greater than or equal to) ◊ LTE (less than or equal to) Date field ◊ E (equal to) ◊ LT (is before) ◊ LTE (is equal to or before) ◊ GT (is after) ◊ GTE (is equal to or after) ◊ BETWEEN (between two dates) Single select list ◊ E (equal to) ◊ NE (not equal to) Multiple choice list ◊ IN (contains) ◊ NIN (does not contain)
contactFilteroption	string		Same as operator

Details below:

columnName	dataType	type	operator	embeddedColumnName
firstName	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
lastName	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
middleInitial	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
suffix	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
externalId	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
country	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
recordTypeId	NUMBER	SYSTEM	E,NE,LT,LTE,GT,GTE
userId	NUMBER	SYSTEM	ISNULL,NOTNULL
individualAccountId	NUMBER	SYSTEM	ISNULL,NOTNULL
lastModifiedDate	DATE	SYSTEM	BETWEEN,LT,LTE,GT,GTE
lastModifiedName	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
registeredEmail	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
registeredDate	DATE	SYSTEM	BETWEEN,LT,LTE,GT,GTE
groups	NUMBER	SYSTEM_ARRAY	IN,NIN
value	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	paths
locationName	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
streetAddress	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
suite	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
city	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
state	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
postalCode	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
country	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
address.gisLocation.lon	NUMBER	SYSTEM	ISNULL,NOTNULL
addressGeoCodingSource	STRING	SYSTEM_OBJECT	IN,NIN	address
locationId	NUMBER	SYSTEM_OBJECT	E,NE,LT,LTE,GT,GTE
floorNo	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
floorNo	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	lastKnownLocation
address.streetAddress	BOOLEAN	SYSTEM	ISNULL,NOTNULL
gisLocation.lat	NUMBER	SYSTEM_OBJECT	E,NE,LT,LTE,GT,GTE	address
gislocation.lon	NUMBER	SYSTEM_OBJECT	E,NE,LT,LTE,GT,GTE	address
pathId	NUMBER	SYSTEM_OBJECT	IN,NIN	paths
createdDate	DATE	SYSTEM	BETWEEN,LT,LTE,GT,GTE
topics	NUMBER	SYSTEM	IN,NIN
systemRequirement	STRING	SYSTEM_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	paths
calendar	NUMBER	SYSTEM_SCHEDULING	E
shift	NUMBER	SYSTEM_SCHEDULING	E
shiftDate	DATE*	SYSTEM_SCHEDULING	BETWEEN
ssoIdentity	STRING	SYSTEM	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
smUserId	NUMBER	SYSTEM	ISNULL,NOTNULL
expectedDate	DATE*	SYSTEM_EXPECTED_OBJECT	BETWEEN,LT,LTE,GT,GTE, BETWEEN
locationName	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
city	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
state	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
country	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
iata	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
locationId	STRING	SYSTEM_EXPECTED_OBJECT	E,NE,LT,LTE,GT,GTE	address
expatriate	NUMBER	SYSTEM	ISNULL,NOTNULL
vip	NUMBER	SYSTEM	ISNULL,NOTNULL
isTravel	BOOLEAN	SYSTEM_EXPECTED_OBJECT	E	address
postalCode	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address
gislocation.lon	NUMBER	SYSTEM_EXPECTED_OBJECT	E,NE,LT,LTE,GT,GTE	address
gisLocation.lat	NUMBER	SYSTEM_EXPECTED_OBJECT	E,NE,LT,LTE,GT,GTE	address
travelType	STRING	SYSTEM_EXPECTED_OBJECT	LIKE,NLIKE	address
supplier	STRING	SYSTEM_EXPECTED_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE	address.expectedLocationSegments
travelDate	DATE	SYSTEM_TRAVEL_SEGMENT_OBJECT	E,BETWEEN
airRailCodeAndNo	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
toLocation.localTravelStatus	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	E,NE
travelSegmentType	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	LIKE,NLIKE
toLocation.iataCode	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	LIKE,NLIKE
fromLocation.iataCode	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	LIKE,NLIKE
diStatus	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	LIKE,NLIKE
supplierName	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	STARTWITH,ENDWITH,E,NE,LIKE,NLIKE
toLocation.countryCode	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	E,NE
fromLocation.countryCode	STRING	SYSTEM_TRAVEL_SEGMENT_OBJECT	E,NE
travelItinerary.startDate	DATE	SYSTEM_TRAVEL_SEGMENT_OBJECT	E,LT,LTE,GT,GTE
travelItinerary.endDate	DATE	SYSTEM_TRAVEL_SEGMENT_OBJECT	E,LT,LTE,GT,GTE

NOTE: columnValue(except sxpectedDate, shiftDate) depends on operator, if it is IN, NIN, BETWEEN, columnValue should be an array, otherwise as data type indicates.
expectedDate and shiftDate are special. Their value should be an array with three elements, and there are only two patterns: ["NOW",null,null] or ["BETWEEN", fromDate, toDate].

Error Messages

status	message
401	Missing Organization Id
500	Internal error