# st.checkConnectionStatus

This action allows you to check the connection status between your account and another person.

> If you need to perform several connection status checks, use this action multiple times within an [array workflow](/docs/building-workflows). This approach is significantly faster than creating separate workflows for each check due to API optimizations.

## Constraints

> ⏺️ **Root Start:** allowed, when `personUrl` parameter is provided.

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

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

## Parameters

```json
{
  "actionType": "st.checkConnectionStatus",
  "label": "person1",
  "personUrl": "https://www.linkedin.com/in/person1"
}
```

- `personUrl` (required for root start, forbidden for parent start) – [public or hashed](/faq/what-are-hashed-url-and-public-url) LinkedIn URL of the person you want to check a connection status with.
- `label` (optional) – custom label for tracking this action in workflow completion.

## Result options

1. **Successful connection check:**

```json
{
  "actionType": "st.checkConnectionStatus",
  "label": "person1",
  "success": true,
  "data": {
    "connectionStatus": "pending"
  }
}
```

- `label` – included only if specified in the action parameters.
- `data.connectionStatus` – enum with the following possible values:
  - `connected` – your account is connected with the person.
  - `notConnected` – your account is not connected with the person.
  - `pending` – your account has a pending connection request to the person.
  - `incoming` – the person has sent your account a connection request that is awaiting your response.

2. **Failed connection check:**

```json
{
  "actionType": "st.checkConnectionStatus",
  "label": "person1",
  "success": false,
  "error": {
    "type": "personNotFound",
    "message": "The provided URL is not an existing LinkedIn person."
  }
}
```

- `label` – included only if specified in the action parameters.
- `error.type` – enum with the following possible values:
  - `personNotFound` – provided URL is not an existing LinkedIn person.
  - `selfProfileNotAllowed` – action cannot be performed on your own profile.