Developers » API methods » Friends » friends.getByPhones
Friendsfriends.getByPhones
Returns a list of the current user's friends whose phone numbers, validated or specified in a profile, are in a given list.
This method can be used only if the current user's mobile phone number is validated. To check the validation, use the users.get method with user_ids=API_USER and fields=has_mobile parameters where API_USER is equal to the current user ID.
This method can be called with a user token received in Standalone-app via Implicit Flow. Access rights required: friends.
Parameters
phonesList of phone numbers in MSISDN format (maximum 1000).

Example:
+79219876543,+79111234567

list of comma-separated words
fieldsProfile fields to return. Sample values: nickname, screen_name, sex, bdate, city, country, timezone, photo_50, photo_100, photo_200_orig, has_mobile, contacts, education, online, counters, relation, last_seen, status, can_write_private_message, can_see_all_posts, can_post, universities.
list of comma-separated words
Result
For users whose validated phone numbers are in the list, returns information as an array of user objects with additional field phone contains a phone number from the list of phone numbers intended for search.
Errors
Global errors can occur while running. See their descriptions on this page.