This section describes parameters that you can use when you search for accounts.

Parameter Description
type

The type of an account:

  • customer
  • reseller
  • operator
  • co - customer’s operators.
  • ro - reseller’s operators.
  • ao - root operators.

For example:

type:customer

type:co

type:(customer, co)

-type:(customer, co)

firstname

The account’s first name or its part.

For example: firstname:John

lastname

The account’s last name or its part.

For example: lastname:Smith

company

The account’s company name or its part.

For example: company:"truehost"

email

The account’s full email.

For example: email:example@example.com

phone

The account’s full phone number.

For example: phone:475-09-23

reseller

The reseller account assigned to an account (customer or operator’s). This can be a reseller to which a customer or operator is directly or indirectly subordinate. This means that the reseller is any level higher in the account hierarchy.

You can specify a reseller account by its ID or its name.

Examples:

reseller:truehost

This query finds accounts that are one or more hierarchical levels lower than accounts that have the word “truehost” in their names. In other words, it finds their direct and indirect subordinate accounts.

-reseller:1234567

This query finds accounts that do not have a reseller with ID=1234567 at any level higher in the account hierarchy.

parent

The parent account assigned to an account. Parent accounts are only one hierarchical level higher.

You can specify a parent account by its ID or its name.

Examples:

parent:plesk

This query finds all accounts that are directly subordinate to the accounts with the word “plesk” in their names. In other words, it finds direct, or immediate, subordinate accounts.

-parent:1234567

This query finds accounts whose parent account has an ID other than 1234567.

apilogin

The Partner API login assigned to a user account.

This parameter supports “:” and “:=” operators. Use the “parameter:=value” notation if you need exact value matching. If matching by a part of a value suits you, use the “parameter:value” notation.

For example:

apilogin:mylogin - a Partner API login contains “mylogin”.

apilogin:=mylogin123 - a Partner API login is exactly “mylogin123”.

geo

The region of the country of an account.

Use an empty string to find accounts for which no region is specified.

The following regions are supported:

  • AMER - Americas
  • APAC - Asia Pacific
  • EUNA - Europe and North Africa
  • RMEA - Russia, Middle East, Africa
  • An empty string (“”) - use it to find accounts for which no region is specified.

geo:APAC

geo:""

geo:(AMER, EUNA, RMEA)

country

The ISO code of the account’s country of residence.

For example:

country: CN

country: DE

majorcustomer

The name or a part of the name of a major customer associated with an account.

Use an empty string (“”) to find accounts for which no major customer is specified.

Example:

majorcustomer:smith - the name of the major customer contains “Smith” as its part.

salesperson

The name or the ID of a salesperson.

If you specify a number, the search is performed against account IDs. If no ID was found, the search is performed against sales person names.

Use an empty string (“”) to find accounts for which no sales person is specified.

Examples:

salesperson:45 - a sales person’s ID = 45.

salesperson:(smith, brown)- a sales person’s name contains either “Smith” or “Brown”.

creation

The date of a user account creation.

Examples:

  • creation: "2014-07-01" - finds accounts created exactly on July 1, 2014.
  • creation > "2014-07-01" - finds accounts created after July 1, 2014.
  • creation >= "2014-07-01" - finds accounts created on July 1, 2014, or later.
  • creation < "2014-07-01" - finds accounts created before July 1, 2014.
  • creation <= "2014-07-01" - finds accounts created on July 1, 2014, or earlier.
  • creation:("2014-07-01" - "2014-07-10") - finds accounts created between July 1 and July 10, 2014, inclusively.
  • creation:("2014-07-01","2014-07-10") - finds accounts created on any of the dates: July 1 or July 10, 2014.
lastlogin

The date when a user last logged in.

Use an empty string (“”) to find accounts for which no date of the last login exists.

Examples:

  • lastlogin: "2014-07-01" - finds accounts that last logged in exactly on July 1, 2014.
  • lastlogin > "2014-07-01" - finds accounts that last logged in later than July 1, 2014.
  • lastlogin >= "2014-07-01" - finds accounts that last logged in either on July 1, 2014, or later.
  • lastlogin < "2014-07-01" - finds accounts that last logged in earlier than July 1, 2014.
  • lastlogin <= "2014-07-01" - finds accounts that last logged in either on July 1, 2014, or earlier.
  • lastlogin:("2014-07-01" - "2014-07-10") - finds accounts that last logged in between July 1 and July 10, 2014, inclusively.
  • lastlogin:("2014-07-01","2014-07-10") - finds accounts that last logged in on any of the dates: July 1 or July 10, 2014.
id

The ID of an account.

Examples:

id:815 - finds accounts with ID = 815.

id:(815, 221) - finds accounts with ID = 815 or ID = 221.

login

The Partner Central login used by an account. Partner Central logins are in fact user emails.

Use an empty string (“”) to find accounts for which no Partner Central login is specified.

Examples:

login:""

login: john@example.com - the login contains “john@example.com” as its part.

login:(joe, john) - the login contains either “joe” or “john”.

login:= john@example.com - the login is exactly john@example.com.

login:=(john@example.com, joe@example.com) - the login is exactly john@example.com or joe@example.com.

alias

The alias of an account, also known as the legacy Key Administrator login.

Examples:

alias: joe - the login alias contains “joe” as its part.

alias:(joe, john) - the login alias contains either “joe” or “john”.

alias:= johnsmith - the login alias is exactly “johnsmith”.

alias:=(johnsmith, johnsm) - the login alias is exactly “johnsmith” or “johnsm”.

access

The system to which the account has access (Key Administrator or Partner Central).

Use an empty string (“”) to find accounts for which no product access is specified.

Examples:

access:""

access:pc - accounts that have access to Partner Central.

access:(ka, pc) - accounts that have access to Key Administrator or Partner Central.

access:[ka, pc] - accounts that have access to both Key Administrator and Partner Central.

totalkeys

The total number of license keys assigned to the account and to all its subordinate accounts.

Supported operators: “:”, “>”, “>=”, “<”, “<=”.

Example:

totalkeys > 50000 - finds accounts that own more than 50000 licenses.

activekeys

The total number of active license keys assigned to the account and to all its subordinate accounts.

Supported operators: “:”, “>”, “>=”, “<”, “<=”.

Example:

activekeys >= 50000 - finds accounts that own 50000 or more active licenses.

expiringkeys

The total number of nearly expired license keys assigned to the account and to all its subordinate accounts. These are licenses with an expiration date within 10 days from the current date.

Supported operators: “:”, “>”, “>=”, “<”, “<=”.

Example:

expiringkeys < 100 - finds accounts that own less than 100 licenses that will expire soon.

expiredkeys

The total number of expired license keys assigned to the account and to all its subordinate accounts.

Supported operators: “:”, “>”, “>=”, “<”, “<=”.

Example:

expiredkeys <= 100 - finds accounts that own 100 or less expired licenses.

suspendedkeys

The total number of suspended license keys assigned to the account and to all its subordinate accounts.

Supported operators: “:”, “>”, “>=”, “<”, “<=”.

Example:

suspendedkeys > 0 - finds accounts that own suspended licenses.

terminatedkeys

The total number of terminated license keys assigned to the account and to all its subordinate accounts.

Supported operators: “:”, “>”, “>=”, “<”, “<=”.

Example:

terminatedkeys:1 - finds accounts that own 1 terminated license.