Developers » User object
User object
user object describes a user profile, contains the following fields:

Default fields
(users.getSubscriptions, groups.getBanned)

uid user ID.
positive number
first_name first name.
string
last_name last name.
string
deactivated returns if a profile is deleted or blocked. Gets the value deleted or banned. Keep in mind that in this case no additional fields are returned.
hidden: 1 returns while operating without access_token if a user has set the "Who can see my profile on the Internet" →"Only VK users" privacy setting. Keep in mind that in this case no additional fields are returned.

Optional fields
(users.get, users.search, users.getFollowers, friends.get, friends.getByPhones, friends.getSuggestions)

verified returns 1 if the profile is verified, 0 if not.
flag, may take 1 and 0 values
blacklisted returns 1 if a current user is in the requested user's blacklist.
flag, may take 1 and 0 values
sex user sex. One of three values is returned:
  • 1 female;
  • 2 male;
  • 0 not specified.

int (number)
bdate user's date of birth. Returned asDD.MM.YYYYorDD.MM(if birth year is hidden). If the whole date is hidden, no field is returned.
string
city ID of the city specified on user's page in "Contacts" section. Returns city ID that can be used to get its name usingplaces.getCityById method. If no city is specified or main information on the page is hidden for in privacy settings, then it returns 0..
string
country ID of the country specified on user's page in "Contacts" section. Returns country ID that can be used to get its name usingplaces.getCountryById method. If no country is specified or main information on the page is hidden in privacy settings, then it returns 0.
positive number
home_town user's home town.
string
photo_50 returns URL ofsquarephoto of the user with 50 pixels in width. In case user does not have a photo,http://vk.com/images/camera_c.gif is returned.
string
photo_100 returns URL ofsquarephoto of the user with 100 pixels in width. In case user does not have a photo,http://vk.com/images/camera_b.gif is returned.
string
photo_200_orig returns URL of user's photo with 200 pixels in width. In case user does not have a photo,http://vk.com/images/camera_a.gif is returned.
string
photo_200 returns URL ofsquarephoto of the user with 200 pixels in width. If the photo was uploaded long time ago, there can be no image of such size and in this case the reply will not include this field.
string
photo_400_orig returns URL of user's photo with 400 pixels in width. If user does not have a photo of such size, reply will not include this field.
string
photo_max returns URL ofsquarephoto of the user with maximum width. Can be returned a photo both 200 and 100 pixels in width. In case user does not have a photo,http://vk.com/images/camera_b.gif is returned.
string
photo_max_orig returns URL of user's photo of maximum size. Can be returned a photo both 400 and 200 pixels in width. In case user does not have a photo,http://vk.com/images/camera_a.gif is returned.
string
online information whether the user is online. Returned values:1 online,0 offline. If user utilizes a mobile application or site mobile version, it returnsonline_mobile additional field that includes1. With that, in case of application,online_app additional field is returned with application ID.
flag, can be 1 or 0
lists information about friend lists. Returns IDs of friend lists the user is member of, separated with a comma. The field is available forfriends.get method only. To get information about ID and names of friend lists usefriends.getLists method. If user is not a member of any friend list, then when accepting data in XML format the respective <user> node does not contain <lists> tag.
string
domain page screen name. Returns a string with a page screen name (only subdomain is returned, like andrew). If not set,"id'+uid is returned, e.g. id35828305.
string
has_mobile Information whether the user's mobile phone number is available. Returned values:1 available,0 not available. We recommend you to use it prior to call ofsecure.sendSMSNotification method.
flag, can be 1 or 0
contacts information about user's phone numbers. If data are available and not hidden in privacy settings, the following fields are returned:
  • mobile_phone user's mobile phone number (only for standalone applications);
  • home_phone user's additional phone number.

string
site returns a website address from a user profile.
education information about user's higher education institution. The following fields are returned:
  • university university ID;
    positive number
  • university_name university name;
    string
  • faculty faculty ID;
    positive number
  • faculty_name faculty name;
    string
  • graduation graduation year.
    positive number
universities list of higher education institutions where user studied. Returnsuniversities array withuniversityobjects with the following fields:
  • id university ID;
    positive number
  • country ID of the country the university is located in;
    positive number
  • city ID of the city the university is located in;
    positive number
  • name university name;
    string
  • faculty faculty ID;
    positive number
  • faculty_name faculty name;
    string
  • chair university chair ID;
    positive number
  • chair_name chair name;
    string
  • graduation graduation year.
    positive number
schools list of schools where user studied in. Returnsschools array withschoolobjects with the following fields:
  • id school ID;
    positive number
  • country ID of the country the school is located in;
    positive number
  • city ID of the city the school is located in;
    positive number
  • name school name;
    string
  • year_from year the user started to study.
    positive number
  • year_to year the user finished to study.
    positive number
  • year_graduated graduation year;
    positive number
  • class school class letter;
    string
  • speciality speciality;
    string
  • type type ID;
    positive number
  • type_str type name.
    string
status user status. Returns a string with status text that is in the profile below user's name.
string
last_seen last visit date. Returnslast_seenobject with the following fields:
  • time - last visit date (in Unix time).
    positive number
  • platform - type of the platform that used for the last authorization. See more at Using LongPoll server.

positive number
followers_count number of user's followers
positive number
common_count number of common friends with a current user.
positive number
counters number of various objects the user has. Can be used inusers.getmethod only when requesting information about a user.
Returns an object with fields:
  • albums number of photo albums;
    positive number
  • videos number of videos;
    positive number
  • audios number of audios;
    positive number
  • notes number of notes;
    positive number
  • friends number of friends;
    positive number
  • groups number of communities;
    positive number
  • online_friends number of online friends;
    positive number
  • mutual_friends number of mutual friends;
    positive number
  • user_videos number of videos the user is tagged on;
    positive number
  • followers number of followers;
    positive number
Fields returned only for desktop applications:
  • user_photos number of photos the user is tagged on;
    positive number
  • subscriptions number of subscriptions (users only);
    positive number
occupation current user's occupation. Returns following fields:
  • type can take the values: work, school, university;
    string
  • id ID of school, university, company group (the one a user works in);
    positive number
  • name name of school, university or work place;
    string

►More