# st.retrievePersonExperience

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

## Constraints

> ⏺️ **Root Start:** not allowed.

> ⬆️ **Parent Actions:** [st.openPersonPage](/docs/action-st-open-person-page).

> ⬇️ **Child Actions:** N/A.

## Parameters

```json
{
  "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.

```json
{
  "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](/faq/what-are-hashed-url-and-public-url) 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.