Retrieving contact list information properties

This parameter specifies the user's email account that is used to request contact information (for example, jamie01@ex365.example.com).

This parameter specifies to search the user's local contacts based on a specific name.

The search results include all contacts with a set of specified characters. For example, "ByName": "Jane" will return all users that have Jane as their first name, last name, or a part of their name.

When you use this parameter, you can also include the UserShape properties "Basic" or "Detail" to retrieve additional information for the returned contacts. See the UserShape parameter below for more information.  

This parameter specifies to search the user's local contact list with a specific email address.

When you use this parameter, you can also include the UserShape parameter properties "Basic" or "Detail" to retrieve additional information for the returned contacts. See the UserShape parameter below for more information.  

This parameter retrieves contacts from the specified FolderId. This is optional. If the FolderId is not specified,

BEMS

retrieves the contacts from the user's contact folder.

This parameter specifies the maximum number of contacts or objects to return in the search query. By default, BEMS can only return up to 512 items at a time. The client must make multiple calls to retrieve more than 512 items by setting the "Offset" parameter. The "MoreAvailable" value tells the client if more items are available. See the API response table below for more information.

This parameter specifies the starting point of a batch response. By default, the Offset is 0 (zero).

This parameter specifies the new or modified contacts in the user's personal contact list since a specified time. SinceTs is specified in epoch time format. If you want to retrieve the new and modified contacts, you must specify the SinceTs to begin searching for contacts.

If the SinceTs is not specified,

BEMS

retrieves all of the contacts from the user's contact folder.

When you use this parameter, you can also include the UserShape parameter properties "Basic" or "Detail" to retrieve additional information for the returned contacts. See the UserShape parameter below for more information.  

This parameter specifies the list of attributes to return in the search results (for example, Basic, MobilePhone, JobTitle, Photo).

UserShape supports a preset list of common properties list: Basic and Detail. The Basic and Detail property name lists can be configured in

BEMS

.

For instructions on how administrators can view or configure the UserShape properties, see Appendix: Configure the UserShape properties.

If MoreAvailable is true, then the client continues to call the API changing the "Offset" value to the value received in the previous response. The client performs this call until the MoreAvailable value is false, which indicates that there are no more contacts to be returned.