# st.retrievePersonLanguages

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

## Constraints

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

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

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

## Parameters

```json
{
  "actionType": "st.retrievePersonLanguages",
  "label": "person1Languages"
}
```

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

## Result options

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

```json
{
  "actionType": "st.retrievePersonLanguages",
  "label": "person1Languages",
  "success": true,
  "data": [
    {
      "name": "English",
      "proficiency": "nativeOrBilingual"
    },
    {
      "name": "Spanish",
      "proficiency": "professionalWorking"
    },
    {
      "name": "French",
      "proficiency": "limitedWorking"
    }
  ]
}
```

- `label` – included only if specified in the action parameters.
- `data` – array of person languages.
  - `name` – name of the language.
  - `proficiency` – proficiency level in the language. Enum with the following possible values:
    - `elementary` – basic understanding.
    - `limitedWorking` – limited ability for routine tasks.
    - `professionalWorking` – effective in professional settings.
    - `fullProfessional` – near-native proficiency.
    - `nativeOrBilingual` – fluent, like a native speaker.