User Search Queries

The key-value syntax, the condition operators, and the logical operators of the user search queries are the same as alert search queries. However, available fields to include in the queries differ from the Alerts Search Query Help queries as expected.

Field Descriptions

Field Name	Description	Example
id	Universally unique identifier of the user as string	`id: b9a2fb13-1b76-4b41-be28-eed2c61978fa`
blocked	Boolean flag that shows if a user is blocked due to a subscription update. Available values are true and false	`blocked: false`
username	Login e-mail of the user as string	`username: [email protected]`
verified	Boolean flag that shows if a user is verified. Available values are true and false	`verified: true`
responder	Boolean flag that shows if a user has either a default role excepting Observer or a custom role extended from a default role excepting Observer. Available values are true and false	`responder: true`
role	Name of the role (default or custom) as string assigned to a user	`role: Admin`
fullName	The combination of the name and the surname of a user as string	`fullName: "Kadir Türker Gülsoy"`
timezone	Time zone of the user as string. Refer to Supported Timezone IDs for possible values.	`timezone: "America/New_York"`
locale	Locale of the user as string. Refer to Supported Locale IDs for possible values.	`locale: "en_US"`
muteUntil	UTC Timestamp that the user is muted until. Format options: Epoch Milliseconds or ISO 8061 Date and Time Format	`muteUntil: 1470394841148` or `muteUntil: "2017-04-03T20:05:50.894Z"`
createdAt	UTC Timestamp when the user was created. Format options: Epoch Milliseconds or ISO 8061 Date and Time Format	`createdAt: 1470394841148` or `createdAt: "2017-04-03T20:05:50.894Z"`
updatedAt	UTC Timestamp when the user was last updated. Format options: Epoch Milliseconds or ISO 8061 Date and Time Format	`updatedAt: 1470394841148` or `updatedAt: "2017-04-03T20:05:50.894Z"`
skypeUsername	Skype username of the user as string	`skypeUsername: phoenix`
tag	Tag of the user as string. Users are matched only if at least one of their tags satisfies the given field-value condition.	`tag: Financier`
address.country	Country of the user as string	`address.country: "United States of America"`
address.state	State (Address) of the user as string	`address.state: California`
address.city	City of the user as string	`address.city: "San Francisco"`
address.line	Address line of the user as string	`address.line: "2166 Foxworthy Ave"`
address.zipCode	ZIP Code of the user's address as string	`address.zipCode: 94016`
details.`<key>`	Value of the custom property of the user for the given key. The key can be any string value.	`details.externalState: Created` or `details."this is a key": "long property value"`

Wildcards

Operator	Description
`*`	Will match more than one character.
`?`	Will match just one character.