# st.retrieveConnections

This action allows you to retrieve your connections and perform additional person-related actions if needed.

## Constraints

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

> ⬆️ **Parent Actions:** N/A.

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

## Parameters

```json
{
  "actionType": "st.retrieveConnections",
  "label": "listConnections1",
  "limit": 100,
  "since": "2022-01-01",
  "filter": {
    "firstName": "John",
    "lastName": "Doe",
    "position": "CEO",
    "locations": ["New York", "San Francisco", "London"],
    "industries": ["Software Development", "Professional Services"],
    "currentCompanies": ["Tech Solutions", "Innovatech"],
    "previousCompanies": ["FutureCorp"],
    "schools": ["Harvard University", "MIT"]
  }
}
```

- `label` (optional) – custom label for tracking this action in workflow completion.
- `limit` (optional) – number of connections to return. Returns all connections if not provided.
- `since` (optional) –  ISO date string that filters connections to only include those made on or after the specified date. Only works when `filter` is not provided.
- `filter` (optional) – object that specifies filtering criteria for people. When multiple filter fields are specified, they are combined using `AND` logic.
  - `firstName` (optional) – first name of person.
  - `lastName` (optional) – last name of person.
  - `position` (optional) – job position of person.
  - `locations` (optional) – array of free-form strings representing locations. Matches if person is located in any of the listed locations.
  - `industries` (optional) – array of enums representing industries. Matches if person works in any of the listed industries. Takes specific values available in the LinkedIn interface.
  - `currentCompanies` (optional) – array of company names. Matches if person currently works at any of the listed companies.
  - `previousCompanies` (optional) – array of company names. Matches if person previously worked at any of the listed companies.
  - `schools` (optional) – array of institution names. Matches if person currently attends or previously attended any of the listed institutions.

## Result options

1. **Successful retrieval:**

```json
{
  "actionType": "st.retrieveConnections",
  "label": "listConnections1",
  "success": true,
  "data": [
    {
      "name": "John Doe",
      "publicUrl": "https://www.linkedin.com/in/johndoe",
      "headline": "Founder & CEO at Example Company",
      "connectedAt": "2025-01-02T00:00:00Z"
    },
    {
      "name": "Jane Smith",
      "publicUrl": "https://www.linkedin.com/in/janesmith",
      "headline": "CEO at Tech Solutions",
      "connectedAt": "2024-11-22T00:00:00Z"
    },
    {
      "name": "Carlos Santos",
      "publicUrl": "https://www.linkedin.com/in/carlossantos",
      "headline": "Project Manager at Startup Hub",
      "connectedAt": "2022-07-06T00:00:00Z"
    }
  ]
}
```

- `label` – included only if specified in the action parameters.
- `data` – array of your connections with results of child actions execution.
  - `name` – full name of the person.
  - `publicUrl` – [public](/faq/what-are-hashed-url-and-public-url) LinkedIn URL of the person.
  - `headline` – headline of the person.
  - `connectedAt` – date when connection was established. Returned only when `filter` is not provided.

2. **Successful retrieval (with filter):**

```json
{
  "actionType": "st.retrieveConnections",
  "label": "listConnections1",
  "success": true,
  "data": [
    {
      "name": "John Doe",
      "publicUrl": "https://www.linkedin.com/in/johndoe",
      "headline": "Founder & CEO at Example Company",
      "location": "Lisbon, Portugal"
    },
    {
      "name": "Jane Smith",
      "publicUrl": "https://www.linkedin.com/in/janesmith",
      "headline": "CEO at Tech Solutions",
      "location": "San Francisco Bay Area"
    },
    {
      "name": "Carlos Santos",
      "publicUrl": "https://www.linkedin.com/in/carlossantos",
      "headline": "Project Manager at Startup Hub",
      "location": "Madrid"
    }
  ]
}
```

- `label` – included only if specified in the action parameters.
- `data` – array of your connections with results of child actions execution.
  - `name` – full name of the person.
  - `publicUrl` – [public](/faq/what-are-hashed-url-and-public-url) LinkedIn URL of the person.
  - `headline` – headline of the person.
  - `location` – free-form string indicating the person's location. Returned only when `filter` is provided.

3. **Failed retrieval:**

```json
{
  "actionType": "st.retrieveConnections",
  "label": "listConnections1",
  "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.