Request contacts using an email address and preset properties Skip Navigation

Request contacts using an email address and preset properties

You can retrieve contacts from a user's contact folder, or folders and subfolders that the user created in the mailbox using multiple properties (for example, retrieve a user based on their email address and include the preset Detail properties for the contact). In this example, the response includes one contact and MoreAvailable is false. If more than 512 contacts are identified, the response indicates that MoreAvailable is true, and the client sends additional requests to retrieve contacts in batches until MoreAvailable is false. If the client provides a FolderId,
BEMS
retrieves the contacts from the specific folder.
POST https://localhost:8443/api/contact HTTP/1.1 Content-Type: application/json X-Good-GD-AuthToken: <
GDAuthToken
> { "Account": "jamie01@ex365.example.com", "ByEmail":"jane_doe@example.com", "MaxNumber": 512, "Offset": 0, "UserShape": ["Details"], "FolderId": "AQMkADk0YzU4MjdkLWU1YjktNGE0OC1iZDczKI0Kuc7BmRwA..."" (optional) }
If the request is successful,
BEMS
returns the following response, and the third-party
BlackBerry Dynamics
apps display the following information for contacts with the email address jane_doe@example.com. If a property is not available,
BEMS
returns a null value and the information is not included in the response. In this example, the following information is displayed for Jane Doe:
  • DisplayName
  • GivenName
  • Surname
  • FullName
  • EmailAddress
{ "LookupInfo": { "MoreAvailable": false, "TotalCount": 1, "NextPageOffset": null, "Size": 1, "Offset": 0 }, "Contacts": [{ "CompleteName": { "Title": null, "GivenName": "Jane", "Surname": Doe, "FullName": "Jane Doe", "Nickname": null, "YomiGivenName": null, "YomiSurname": null }, "DisplayName": "Jane Doe", "EmailAddress": "jane_doe@example.com", "GivenName": "Jane", "UniqueId" : "AAMkADg2Y2IxMzAwLWJmZmYtNGJjMi1iN..." }, ] }