Definition of projections (attributes to fetch for each record), filters to apply on results and sorting options
aggregations
Array[Aggregation]
List of aggregations to perform on result set returned by query (after all the filters, including default permission filters, are applied)
suggestions
Array[Suggestion]
List of search values for which suggestions are to be found
hits
Boolean
indicates whether search results should be returned or not (e.g. in case of aggregation request, single components may not be needed), defaults to true
cursor
String
pagination token for stateless iteration over data set
page
Integer
page number of results to be returned (a page is per_page records), defaults to 0
per_page
Integer
maximum number of records to display at a time, defaults to 50
offset
Integer
number of results to skip (after all filters and sorting are applied), defaults to 0
Validation rules
cursor, offset and page are mutually exclusive
page must be non-negative
per_page must be within range 0-200
The cursor property is not included in the initial HTTP request. If the search results span multiple pages, this initial request returns a cursor value, which can be used in a subsequent pagination request to retrieve the next page of results.
Projection definition: list of attributes to fetch for every record (by default only id and version are fetched, anything else must be requested explicitly)
filter
Filter
Filters to apply to results set (permissions and visibility filters are always applied whether requested or not, so that user sees only records she has access to)
sort
Array[Sort]
List of attributes to sort result set on; sorts are applied in order they are specified, meaning if records have the same value of some sort attribute, then the next sort attribute (if defined) is used to order records within that group
Filter
Attribute
Type
Description
and
Array[Filter]
AND logical operator for filters
or
Array[Filter]
OR logical operator for filters
not
Filter
NOT logical operator for filters
filter
FilterOperand
concrete filter specifying an attribute and condition it must meet for this filter to match
FilterOperand
Attribute
Type
Description
attribute
Attribute
attribute to filter records on
parameter
FilterOperator
concrete condition that attribute must meet
FilterOperator
Attribute
Type
Description
any
Array[AnyType]
attribute must have one of specified values
all
Array[AnyType]
attribute must have all of specified values (applies to array attributes)
contains
String
attribute must contain specified phrase
starts_with
String
attribute must start with specified phrase (limited to 256 characters, longer input will be trimmed to that length)
eq
AnyType
attribute value must be equal to specified
missing
Boolean
attribute == null must evaluate to missing (same as is_null)
is_null
Boolean
attribute == null must evaluate to is_null (same as missing)
range
Range
attribute value must be within range
geo_distance
GeoDistance
geo point attribute must be within specified range
Validation rules
All elements in any or all must be of the same type and that type must match filtered argument type
Exactly one of FilterOperators attributes must be non-null
Filter type must be allowed by attribute type
Type
Allowed filters
Id
any eq range missing is_null
Version
any eq range graph_expression
PermissionsOwner PermissionsTeam PermissionsGroup
any eq
short byte integer long double
any eq range missing is_null
string
starts_with any eq contains missing is_null
boolean
any eq missing is_null
date date-time
any eq range missing is_null
array
Filters allowed by type of stored elements, plus additional filter: all
object
Filtering cannot be done explicitly on an object, but it can be done on it's attributes. If object has filter_field set in mapping, then any filter specified directly on this object will be resolved against that attribute (including type validation).
CustomField
Every CustomField has some underlying data type. All of them are described above, and undergo the same rules.
GeoPoint
geo_distance
Range
Attribute
Type
Description
gte
AnyType
lower range bound (inclusive)
gt
AnyType
lower range bound (exclusive)
lte
AnyType
upper range bound (inclusive)
lt
AnyType
upper range bound (exclusive)
Validation rules
At most one of lower bounds [gte, gt] may be specified
At most one of upper bound [lte, lt] may be specified
GeoDistance
Attribute
Type
Description
distance_meters
Decimal
radius of circle centred in the from location (in meters)
value to use (in filtering, sorts and aggregations) if attribute is missing in record
Validation rules
name must be defined in mapping for given index (either directly, e.g. display_name for contacts or as field of an object with dot notation, e.g. address.street in contacts)
Privacy Preference Center
Zendesk uses web cookies to collect information about you when you visit our Site. This information might be about you, your preferences, or your device. At Zendesk, we may use this information for purposes that include ensuring basic functionality of our Sites; remembering user preferences, including your cookie preferences; measuring the effectiveness of our Sites, marketing campaigns, and email communications; and personalizing online content.
Please review the different category headings below to learn more and adjust the cookie settings on your current device. Please note that you will need to ensure that each web browser is adjusted to reflect your preferences if you use different computers or mobile devices.
For more information about how Zendesk uses web cookies, please see our Cookie Notice.
Manage Consent Preferences
Essential Cookies
Always Active
Essential cookies enable core site functionality. These cookies are necessary for the Site to function and cannot be switched off in our systems. You may set your browser to block or alert you about these cookies, but parts of the website may not function properly.
Functional Cookies
Functional cookies enable the Site to provide enhanced functionality and personalization. These cookies may be set by us or by third-party providers whose services we have added to our Site.
Analytics Cookies
Analytics cookies allow us to count visits and traffic sources so we can measure and improve the performance of our Site. These cookies help us to know which pages are the most and least popular and see how visitors move around the Site.
Targeting Cookies
Targeting cookies, such as social media cookies, may be set through our Site by our advertising service providers, third-party advertisers, ad networks, or data exchange partners. These cookies may be used to show you relevant advertising on other third-party sites.