Profile Fields

LinkedIn Members publish a variety of information about themselves on their member profile. You can retrieve these using our APIs by explicitly listing the fields you want using field selectors in your URL.

Not all fields are available for all profiles. The fields available depend on the relationship between the user you are making a request on behalf of and the member, the information that member has chosen to provide, and their privacy settings. You should not assume that anything other than id is returned for a given member. If a member has chosen to opt out of data sharing with third parties, requests for their profile return as private for id and last-name. (This means id is not a unique field.) This affects data retrieved from all APIs, such as a person's connections, recommendations, people search, network updates, or status updates. Code defensively!

For members other than the ones using your application, you may only retrieve the profile fields available with the r_basicprofile member permission.

Jump to:

Field Details:

Basic Profile Fields

These fields require the r_basicprofile member permission
Field Parent Node Description Notes
id person a unique identifier token for this member This field might return a value of private for users other than the currently logged-in user depending on the member's privacy settings
first-name person the member's first name This field might be omitted from some results depending on the member's privacy settings
last-name person the member's last name This field might be omitted from some results or return a value of private, depending on the member's privacy settings
maiden-name person the member's maiden name This field might be omitted from some results or return a value of private, depending on the member's privacy settings
formatted-name person the member's name formatted based on language This field might be omitted from some results or return a value of private, depending on the member's privacy settings
phonetic-first-name person the member's first name spelled phonetically This field might be omitted from some results depending on the member's privacy settings
phonetic-last-name person the member's last name spelled phonetically This field might be omitted from some results depending on the member's privacy settings
formatted-phonetic-name person the member's name spelled phonetically and formatted based on language This field might be omitted from some results or return a value of private, depending on the member's privacy settings
headline person the member's headline (often "Job Title at Company")
location:(name) person Generic name of the location of the LinkedIn member, (ex: "San Francisco Bay Area")
location:(country:(code)) person country code for the LinkedIn member Lower case values as defined by ISO 3166-1 alpha-2 standard.
industry person the industry the LinkedIn member has indicated their profile belongs to (Industry Codes)
distance person the degree distance of the fetched profile from the member who fetched the profile

Values are:

  • 0: the member
  • 1, 2, and 3: # of degrees apart
  • -1: out of network
  • 100: share a group, but not within 3 degrees (will get 1-3 instead)
relation-to-viewer:(distance) person the degree distance of the fetched profile from the member who fetched the profile Not available in /people/{id}/connections.
relation-to-viewer:(related-connections) person Contains brief connection/person objects indicating the connecting first degree members Not available in /people/{id}/connections. For each connection, id, first-name, and last-name is returned by default. You can fetch distance using field selectors, for e.g. relation-to-viewer:(related-connections:(id,first-name,last-name,distance))

relation-to-viewer:(connections)

Deprecated

person Deprecated: a total attribute will denote the number of connections that link  the fetching member to the fetched. Contains brief connection/person objects indicating the connecting first degree members Deprecated. Use the related-connections field instead. It gives the same information but splits out the count into the num-related-connections field so you can get each separately instead of having to get them together.
current-share person the member's current share, if set
num-connections person the # of connections the member has Available in some places, such as /people/~/connections, when connections is not. More efficient than checking the total attribute of connections even when connections is available.
num-connections-capped person true if the value of num-connections has been capped at 500. false otherwise. Allows you to distinguish whether num-connections = 500 because the member has exactly 500 connections or actually 500+ because we're hiding the true value.
summary person A long-form text area where the member describes their professional profile Not available via connections API.
specialties person A short-form text area where the member enumerates their specialties Not available via connections API.
positions person A collection of positions a member has had, the total indicated by a total attribute

See Positions Fields below. Only current positions are available for people other than the authenticated member.

picture-url person A URL to the profile picture, if the member has associated one with their profile and it is visible to the requestor
site-standard-profile-request person The URL to the member's authenticated profile on LinkedIn (requires a login to be viewed, unlike public profiles)
api-standard-profile-request:(url) person A URL representing the resource you would request for programmatic access to the member's profile
api-standard-profile-request:(headers) person A collection of fields that can be re-used as HTTP headers to request an out of network profile programmatically Use the name returned as the name of an HTTP header with the value returned as it's value
public-profile-url person A URL to the member's public profile, if enabled This field is only available when requested using a field selector in a profile or connections call.

Email Fields

These fields require the r_emailaddress member permission

Field Parent Node Description Notes
email-address person primary email address of user

Full Profile Fields

These fields require the r_fullprofile member permission

Field Parent Node Description Notes
last-modified-timestamp person the timestamp, in milliseconds, when the member's profile was last edited
proposal-comments person A short-form text area describing how the member approaches proposals
associations person A short-form text area enumerating the Associations a member has
interests person A short-form text area describing the member's interests
publications person A collection of publications authored by this member See Publications Fields below
patents person A collection of patents or patent applications held by this member See Patents Fields below
languages person A collection of languages and the level of the member's proficiency for each

See Languages Fields below

skills person A collection of skills held by this member

See Skills Fields below

certifications person A collection of certifications earned by this member See Certifications Fields below
educations person A collection of education institutions a member has attended, the total indicated by a total attribute See Educations Fields below
courses person A collection of courses a member has taken, the total indicated by a total attribute See Courses Fields below
volunteer person A collection of volunteering experiences a member has participated in, including organizations and causes, the totals indicated by a total attribute See Volunteer Experience Fields below
three-current-positions person

A collection of positions a member currently holds, limited to three and indicated by a total attribute.

You can use the <positions> collection to get the full set or use this collection to limit the return to just the first three positions.

See Positions Fields below

three-past-positions person

A collection of positions a member formerly held, limited to the three most recent and indicated by a total attribute.

You can use the <positions> collection to get the full set or use  this collection to limit the return to just the first three positions.

See Positions Fields below

num-recommenders person The number of recommendations the member has
recommendations-received person A collection of recommendations a member has received. See Recommendations Fields below
following person a collection of people, company, and industries that the member is following
job-bookmarks person a collection of jobs that the member is following
suggestions person a collection of people, company, and industries suggested for the member to follow
date-of-birth person member's birth date May return only month and day, but not year, or all three, depending on information provided.
member-url-resources person A collection of URLs the member has chosen to share on their LinkedIn profile
member-url-resources:(url) person/member-url-resources The fully-qualified URL being shared
member-url-resources:(name) person/member-url-resources The label given to the URL by the member
related-profile-views person A collection of related profiles that were viewed before or after the member's profile
honors-awards person A collection of honors and awards the member specified in their LinkedIn profile

Contact Info Fields

These fields require the r_contactinfo member permission

Field Parent Node Description Notes
phone-numbers person a collection of phone numbers For each phone-number returned, you get a phone-type and phone-number child element. Possible values for phone-type are: home, work, and mobile.
bound-account-types person a collection of accounts bound by the member For each bound account returned, you get the following child elements:
  • account-type
  • binding-status
  • is-primary
  • provider-account-id
  • provider-account-name child element
im-accounts person a collection of instant messenger accounts For each im-account returned, you get a im-account-type and im-account-name child element. Possible values for im-account-type are: aim, gtalk, icq, msn, skype, and yahoo.
main-address person address Could be home, work, etc. We do not identify which one.
twitter-accounts person a collection of twitter accounts For each twitter-account returned, you get a provider-account-id and provider-account-name child element.
primary-twitter-account person the primary twitter account for the member You get a provider-account-id and provider-account-name child element.

Connection Fields

These fields require the r_network member permission

Field Parent Node Description Notes
connections person an empty collection, indicating the # of connections the member has with a total attribute LinkedIn will not report whether a user has more than 500 connections

Group Membership Fields

These fields require the rw_groups membership permission

Field Parent Node Description Notes
group-memberships person a collection of groups that the member is following

Network Update Fields

These fields require the rw_nus membership permission

Field Parent Node Description Notes
network person the member's network statistics and updates

Return to top

Positions

Positions are structured objects returned as part of profile.

Field Parent Node Description Notes
id position a unique identifier for this member's position
title position the job title held at the position, as indicated by the member
summary position a summary of the member's position Not available via connections.
start-date position a structured object with month and year fields indicating when the position began
end-date position a structured object with month and year fields indicating when the position ended Blank when the position is current
is-current position a "true" or "false" value, depending on whether it is marked current
company position the company the member works for See Company Fields below

Return to top

Company

Company is a structured object returned as part of profile.

Not used directly with people calls, but used in position calls.

Field Parent Node Description Notes
id company the ID for the company (useful with facets or the Company API)
name company the name of the company
type company indicates if the company is public or private
size [deprecated] company the number of employees at the company Expressed as a range
industry company the industry in which the company operates(Industry Codes) For example, Computer Software or Defense & Space
ticker company the stock market name for the company, if the company type is public

Return to top

Publications

Individual publications are structured objects returned as part of profile.

Field Parent Node Description Notes
id publication A unique identifier for this member's publication entry
title publication A string describing the title of this publication
publisher:(name) publication A string that indicates the name of the publisher of this publication
authors:(id) publication A unique identifier for this author in the list of authors
authors:(name) publication A string that indicates the name of this author as it should be displayed
authors:(person) publication An optional field that displays the default LinkedIn member name (person field) for this particular member
date publication A structured object with day, month, and year fields indicating when the publication was published. Each individual field is optional, but if month is populated, year must be populated, if day is populated, month must be populated.
url publication A URL for the publication Can either be the publication itself or a page with more information on the publication.
summary publication A string summary of the publication

Return to top

Patents

Individual patents are structured objects returned as part of profile.

Field Parent Node Description Notes
id patent A unique identifier for this member's patent entry
title patent The patent title
summary patent A short summary of the patent
number patent A string with the patent or application number Example: 7,720,722
status:(id) patent An ID indicating whether this is a granted patent or patent application Values are 0 for patent application; 1 for granted patent
status:(name) patent A string indicating whether this is a granted patent or patent application Values are Application and Patent
office:(name) patent A structured object describing the patent issuing body. Example: for the USPTO, the value is us
inventors:(id) patent A unique identifier for this inventor in the list of inventors
inventors:(name) patent A string that indicates the name of this inventor as it should be displayed This is the name as it appears on the patent (which can differ from a person's name on LinkedIn).
inventors:(person) patent An optional field that shows the LinkedIn member object for this particular member Default values are id, first-name, and last-name
date patent A structured object with day, month, and year fields indicating when the application was filed or when the patent was granted. Each individual field is optional, but if month is populated, year must be populated, if day is populated, month must be populated.
url patent The URL to the patent

Return to top

Languages

Individual languages are structured objects returned as part of profile.

Field Parent Node Description Notes
id language A unique identifier for a single language in the list of languages
language:(name) language A structured object specifying the language name May be localized in the future
proficiency:(level) language A structured object indicating the user's fluency. Returns one of the following five values:
  • elementary
  • limited-working
  • professional-working
  • full-professional
  • native-or-bilingual
This field is for computer programs.
proficiency:(name) language A structured object specifying the user's fluency by name.
  • Elementary proficiency
  • Limited working proficiency
  • Professional working proficiency
  • Full professional proficiency
  • Native or bilingual proficiency
This field is for humans to read. It may be localized in the future.

Return to top

Skills

Individual skills are structured objects returned as part of profile.

Field Parent Node Description Notes
id skill A unique identifier for a single skill in the list of skills
skill:(name) skill A structured object that indicates the internationalized name of the canonical language

Return to top

Certifications

Individual certifications are structured objects returned as part of profile.

Field Parent Node Description Notes
id certification A unique identifier for this certification
name certification A string indicating the name of this certification
authority:(name) certification A structured object containing the name of the certification's issuing body
number certification A string describing the license number for this certification
start-date certification A structured object with day, month, and year fields indicating the start date for the certification. Each individual field is optional, but if month is populated, year must be populated, if day is populated, month must be populated.
end-date certification A structured object with day, month, and year fields indicating the end date for the certification. Each individual field is optional, but if month is populated, year must be populated, if day is populated, month must be populated.

Return to top

Educations

Educations are structured objects returned as part of profile.

Field Parent Node Description Notes
id educations a unique identifier for this member's education entry
school-name educations the name of the school, as indicated by the member
field-of-study educations the field of study at the school, as indicated by the member
start-date educations a structured object a year field indicating when the education began
end-date educations a structured object with a year field indicating when the education ended Blank when the education is current
degree educations a string describing the degree, if any, received at this institution
activities educations a string describing activities the member was involved in while a student at this institution
notes educations a string describing other details on the member's studies.

Return to top

Courses

Courses are structured objects returned as part of profile.

Field Parent Node Description Notes
id course a unique identifier for this member's course entries
name course a string identifying the name of the course, as entered by the member
number course the course number assigned, as entered by the member

Return to top

Volunteer Experience Fields

Volunteer experiences are structured objects returned as part of profile.

Field Parent Node Description Notes
id volunteer-experience a unique identifier for this member's volunteer entries
role volunteer-experience the role the member has performed as a volunteer
organization:(name) volunteer-experience the name of an organization the member has volunteered with
cause:(name) volunteer-experience a string describing causes the member has listed

Return to top

Recommendations Fields

Recommendations are structured objects returned as part of profile.

Field Parent Node Description Notes
id recommendation a unique identifier for this recommendation
recommendation-type recommendation indicates type of recommendation that was selected by the person making the recommendation
recommendation-text recommendation the text of the recommendation received
recommender recommendation a collection defining the person who made the recommendation

Return to top