Get LinkedIn grouped employment history Get grouped employment history for a LinkedIn person.
GET /v2/linkedin/people/{entityId}/employment-history
x-api-key* string header
API key (`sfk_...`)
entityId* string required path
LinkedIn person entity ID. Not a vanity handle.
min 1 chars · max 500 chars
Response fields 120 Expand all Collapse all Collapse all data . employmentHistory . employmentHistory array nullable
Employment history grouped by organization.
data . employmentHistory . employmentHistory [] . title
string nullable
Role title when observed.
data . employmentHistory . employmentHistory [] . subtitle
string nullable
Role subtitle when observed.
data . employmentHistory . employmentHistory [] . description
string nullable
Role description when observed.
data . employmentHistory . employmentHistory [] . employmentType
string nullable
Employment type label when observed.
data . employmentHistory . employmentHistory [] . location
string nullable
Role location when observed.
data . employmentHistory . employmentHistory [] . locationType
string nullable
Remote or workplace label when observed.
data . employmentHistory . employmentHistory [] . duration
string nullable
Source duration label when observed.
data . employmentHistory . employmentHistory [] . isCurrent
boolean nullable
Whether this is a current role when observed.
data . employmentHistory . employmentHistory [] . isMultiPositions
boolean nullable
Whether the organization contains multiple roles when observed.
data . employmentHistory . employmentHistory [] . start object nullable
Role start date when observed.
data . employmentHistory . employmentHistory [] . start . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . start . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . start . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . end object nullable
Role end date when observed.
data . employmentHistory . employmentHistory [] . end . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . end . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . end . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . durationParsed object nullable
Parsed duration fields when observed.
data . employmentHistory . employmentHistory [] . durationParsed . start object nullable
Parsed start date when observed.
data . employmentHistory . employmentHistory [] . durationParsed . start . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . durationParsed . start . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . durationParsed . start . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . durationParsed . end object nullable
Parsed end date when observed.
data . employmentHistory . employmentHistory [] . durationParsed . end . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . durationParsed . end . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . durationParsed . end . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . durationParsed . period
string nullable
Parsed duration label when observed.
data . employmentHistory . employmentHistory [] . durationParsed . present
boolean nullable
Whether the parsed duration is ongoing when observed.
data . employmentHistory . employmentHistory [] . organization object nullable
Nested organization summary when observed.
data . employmentHistory . employmentHistory [] . organization . id
string nullable
Organization identifier when observed.
data . employmentHistory . employmentHistory [] . organization . name
string nullable
Organization name when observed.
data . employmentHistory . employmentHistory [] . organization . url
string nullable
Organization URL when observed.
data . employmentHistory . employmentHistory [] . organization . logoUrl
string nullable
Organization logo URL when observed.
data . employmentHistory . employmentHistory [] . organizationId
string nullable
Organization identifier when observed.
data . employmentHistory . employmentHistory [] . organizationName
string nullable
Organization name when observed.
data . employmentHistory . employmentHistory [] . organizationUrl
string nullable
Organization URL when observed.
data . employmentHistory . employmentHistory [] . organizationLogo
string nullable
Organization logo URL when observed.
data . employmentHistory . employmentHistory [] . organizationHandle
string nullable
Live organization handle when observed.
data . employmentHistory . employmentHistory [] . organizationSlug
string nullable
Data organization slug when observed.
data . employmentHistory . employmentHistory [] . organizationIndustry
string nullable
Organization industry when observed.
data . employmentHistory . employmentHistory [] . organizationHeadcountRange
string nullable
Organization headcount range when observed.
data . employmentHistory . employmentHistory [] . multiLocaleTitle array nullable
Localized role titles when observed.
data . employmentHistory . employmentHistory [] . multiLocaleTitle [] . locale
string
Source locale identifier.
data . employmentHistory . employmentHistory [] . multiLocaleTitle [] . value
string nullable
Text translated for the locale when observed.
data . employmentHistory . employmentHistory [] . multiLocaleOrganizationName array nullable
Localized organization names when observed.
data . employmentHistory . employmentHistory [] . multiLocaleOrganizationName [] . locale
string
Source locale identifier.
data . employmentHistory . employmentHistory [] . multiLocaleOrganizationName [] . value
string nullable
Text translated for the locale when observed.
data . employmentHistory . employmentHistory [] . skills array nullable
Position skills when observed.
data . employmentHistory . employmentHistory [] . skills []
string nullable optional
Position skill when observed.
data . employmentHistory . employmentHistory [] . positions array nullable
Grouped roles at the same organization when observed.
data . employmentHistory . employmentHistory [] . positions [] . title
string nullable
Role title when observed.
data . employmentHistory . employmentHistory [] . positions [] . subtitle
string nullable
Role subtitle when observed.
data . employmentHistory . employmentHistory [] . positions [] . description
string nullable
Role description when observed.
data . employmentHistory . employmentHistory [] . positions [] . employmentType
string nullable
Employment type label when observed.
data . employmentHistory . employmentHistory [] . positions [] . location
string nullable
Role location when observed.
data . employmentHistory . employmentHistory [] . positions [] . locationType
string nullable
Remote or workplace label when observed.
data . employmentHistory . employmentHistory [] . positions [] . duration
string nullable
Source duration label when observed.
data . employmentHistory . employmentHistory [] . positions [] . isCurrent
boolean nullable
Whether this is a current role when observed.
data . employmentHistory . employmentHistory [] . positions [] . isMultiPositions
boolean nullable
Whether the organization contains multiple roles when observed.
data . employmentHistory . employmentHistory [] . positions [] . start object nullable
Role start date when observed.
data . employmentHistory . employmentHistory [] . positions [] . start . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . positions [] . start . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . positions [] . start . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . positions [] . end object nullable
Role end date when observed.
data . employmentHistory . employmentHistory [] . positions [] . end . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . positions [] . end . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . positions [] . end . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed object nullable
Parsed duration fields when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . start object nullable
Parsed start date when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . start . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . start . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . start . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . end object nullable
Parsed end date when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . end . day
number nullable
Day of month when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . end . month
number nullable
Month number when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . end . year
number nullable
Four digit year when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . period
string nullable
Parsed duration label when observed.
data . employmentHistory . employmentHistory [] . positions [] . durationParsed . present
boolean nullable
Whether the parsed duration is ongoing when observed.
data . employmentHistory . employmentHistory [] . positions [] . organization object nullable
Nested organization summary when observed.
data . employmentHistory . employmentHistory [] . positions [] . organization . id
string nullable
Organization identifier when observed.
data . employmentHistory . employmentHistory [] . positions [] . organization . name
string nullable
Organization name when observed.
data . employmentHistory . employmentHistory [] . positions [] . organization . url
string nullable
Organization URL when observed.
data . employmentHistory . employmentHistory [] . positions [] . organization . logoUrl
string nullable
Organization logo URL when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationId
string nullable
Organization identifier when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationName
string nullable
Organization name when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationUrl
string nullable
Organization URL when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationLogo
string nullable
Organization logo URL when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationHandle
string nullable
Live organization handle when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationSlug
string nullable
Data organization slug when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationIndustry
string nullable
Organization industry when observed.
data . employmentHistory . employmentHistory [] . positions [] . organizationHeadcountRange
string nullable
Organization headcount range when observed.
data . employmentHistory . employmentHistory [] . positions [] . multiLocaleTitle array nullable
Localized role titles when observed.
data . employmentHistory . employmentHistory [] . positions [] . multiLocaleTitle [] . locale
string
Source locale identifier.
data . employmentHistory . employmentHistory [] . positions [] . multiLocaleTitle [] . value
string nullable
Text translated for the locale when observed.
data . employmentHistory . employmentHistory [] . positions [] . multiLocaleOrganizationName array nullable
Localized organization names when observed.
data . employmentHistory . employmentHistory [] . positions [] . multiLocaleOrganizationName [] . locale
string
Source locale identifier.
data . employmentHistory . employmentHistory [] . positions [] . multiLocaleOrganizationName [] . value
string nullable
Text translated for the locale when observed.
data . employmentHistory . employmentHistory [] . positions [] . skills array nullable
Position skills when observed.
data . employmentHistory . employmentHistory [] . positions [] . skills []
string nullable optional
Position skill when observed.
data . employmentHistory . employmentHistory [] . totalDuration
string nullable
Aggregate duration of grouped roles when observed.
one of: cursor, offset, page
data . page . nextCursor
string nullable
data . page . hasMore
boolean nullable
Null when continuation is unknown for this page.
data . page . start
integer nullable
data . page . page
integer nullable
data . page . count
integer nullable
data . page . returnedCount
integer
data . page . total
integer nullable
data . page . totalPages
integer nullable
data . reportedTotal
number nullable
Total reported for this page of results; not a guarantee of globally retrievable matches.
Metadata about the API response.
Unique request identifier for tracing this API call.
meta . creditsCharged
integer
Credits charged for this request.
Public API version that served the response.