st.retrievePersonExperience

This action allows you to retrieve information about a person's experience.

Constraints

Parameters

{
  "actionType": "st.retrievePersonExperience",
  "label": "person1Experience"
}

• label (optional) – custom label for tracking this action in workflow completion.

Result options

This action always completes successfully. Even if the person has no experience records, it returns an empty array.

{
  "actionType": "st.retrievePersonExperience",
  "label": "person1Experience",
  "success": true,
  "data": [
    {
      "position": "Software Engineer",
      "companyName": "TechCorp",
      "companyHashedUrl": "https://www.linkedin.com/company/12345678",
      "employmentType": "fullTime",
      "locationType": "onSite",
      "description": "Developing innovative software solutions.",
      "duration": 24,
      "startTime": "2021-01-01T00:00:00Z",
      "endTime": null,
      "location": "San Francisco, USA"
    },
    {
      "position": "Junior Developer",
      "companyName": "CodeBase Inc.",
      "companyHashedUrl": "https://www.linkedin.com/company/87654321",
      "employmentType": "internship",
      "locationType": "remote",
      "description": "Worked on front-end development tasks.",
      "duration": 12,
      "startTime": "2020-01-01T00:00:00Z",
      "endTime": "2020-12-31T00:00:00Z",
      "location": null
    }
  ]
}

• label – included only if specified in the action parameters.
• data – array of person experience records.
  • position – job position held by the person.
  • companyName – name of the company where the person worked.
  • companyHashedUrl – hashed LinkedIn URL of the company where the person worked.
  • employmentType – type of employment. Enum with the following values:
    • fullTime – full-time employment.
    • partTime – part-time employment.
    • selfEmployed – self-employed work.
    • freelance – freelance work.
    • contract – contract-based employment.
    • internship – internship position.
    • apprenticeship – apprenticeship program.
    • seasonal – seasonal employment.
  • locationType – type of location. Enum with the following values:
    • remote – position is fully remote.
    • onSite – position requires on-site work.
    • hybrid – position is a mix of remote and on-site work.
  • description – description of the job or responsibilities.
  • duration – number of months the person worked in the position.
  • startTime – timestamp of the first day of the month when the person started the position.
  • endTime – timestamp of the last day of the month when the person ended the position. Returns null if the person is still working in this position.
  • location – free-form string indicating the location of the position.