Version 3, last updated by Maxim Cretu at June 16, 2011 07:05 UTC
User Search API
/user/search allows you to search for an user by email, external_id or login.
Note: search by email and external_id is only enabled in private installations.
To make a search, do GET to
/user/search?field=login&value=bob
where “field” param can be [login, email, external_id]
Search by email may return more than one results. So, the XML document will always start with “users” root element:
<users type="array">
<user>
<id>bJLkJOaP0r34yvab6mh4p6</id>
<login_name>bob</login_name>
</user>
</users>
/user/search will return Not Found (404), and an empty document, if no results were found.
The Search is public, so no IM or any other private field will be shown, even if the search is done by the owner of an account.