# st.retrieveCompanyDMs

This action allows you to retrieve company decision makers and perform additional person-related actions if needed.

> Decision makers are ranked by seniority, starting with the highest-level positions. For example, founders and C-level executives are returned first, followed by VPs, directors, and so on.

## Constraints

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

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

> ⬇️ **Child Actions:** [st.doForPeople](/docs/action-st-do-for-people).

## Parameters

```json
{
  "actionType": "st.retrieveCompanyDMs",
  "label": "company1DMs",
  "limit": 3,
  "then": { ... }
}
```

- `label` (optional) – custom label for tracking this action in workflow completion.
- `limit` (optional) – number of decision makers to retrieve. Defaults to **20**, with a maximum value of **20**. If a company has fewer decision makers than specified, only the available ones will be returned.
- `then` (optional) – object or array of child actions to be executed within this action.

## Result options

1. **Successful retrieval:**

```json
{
  "actionType": "st.retrieveCompanyDMs",
  "label": "company1DMs",
  "success": true,
  "data": [
    {
      "name": "John Doe",
      "publicUrl": "https://www.linkedin.com/in/johndoe",
      "headline": "Founder of TechCorp",
      "location": "New York, USA",
      "countryCode": "US",
      "then": { ... }
    },
    {
      "name": "Jane Smith",
      "publicUrl": "https://www.linkedin.com/in/janesmith",
      "headline": "CEO at TechCorp",
      "location": "San Francisco, USA",
      "countryCode": "US",
      "then": { ... }
    }
  ]
}
```

- `label` – included only if specified in the action parameters.
- `data` – array of decision makers with results of child actions execution.
  - `name` – full name of the decision-maker.
  - `publicUrl` – [public](/faq/what-are-hashed-url-and-public-url) LinkedIn URL of the decision-maker.
  - `headline` – headline of the decision-maker.
  - `location` – free-form string indicating the decision-maker's location.
  - `countryCode` – two-character code of the decision-maker's country.
  - `then` – results of child actions execution.

2. **Failed retrieval:**

```json
{
  "actionType": "st.retrieveCompanyDMs",
  "label": "company1DMs",
  "success": false,
  "error": {
    "type": "retrievingNotAllowed",
    "message": "LinkedIn has blocked performing the retrieval."
  }
}
```

- `label` – included only if specified in the action parameters.
- `error.type` – enum with the following possible values:
  - `retrievingNotAllowed` – LinkedIn has blocked performing the retrieval due to exceeding limits or other restrictions.