> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Connections

> Retrieve your LinkedIn connections list with pagination support

Get a list of your LinkedIn connections with their basic information including name, job title, profile URL, and profile picture. Supports both pagination and total results modes.

<Note>
  Credit cost varies based on usage mode:

  * Pagination mode: **1 credit per page**
  * Total results mode: **1 credit per 10 connections** (rounded up)
</Note>

### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key
</ParamField>

### Body Parameters

<ParamField body="login_token" type="string" required>
  LinkedIn authentication cookie obtained from the login/verify process
</ParamField>

<ParamField body="country" type="string" default="FR">
  Country code for proxy selection. Available: (US, UK, FR, DE, NL, IT, IL, CA, BR, ES, IN)
</ParamField>

<ParamField body="start_page" type="integer">
  Starting page number for pagination mode
</ParamField>

<ParamField body="end_page" type="integer">
  Ending page number for pagination mode
</ParamField>

<ParamField body="total_results" type="integer" default="10">
  Number of connections to retrieve (used when not in pagination mode)
</ParamField>

### Response

<ResponseField name="status" type="string">
  Request status (success/error)
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Properties">
    <ResponseField name="total_results" type="integer">
      Number of connections returned in this response
    </ResponseField>

    <ResponseField name="total_available_results" type="integer">
      Total number of connections available in your network
    </ResponseField>

    <ResponseField name="connections" type="array">
      <Expandable title="Connection Object">
        <ResponseField name="name" type="string">
          Full name of the connection
        </ResponseField>

        <ResponseField name="job_title" type="string">
          Current job title or professional headline
        </ResponseField>

        <ResponseField name="profile_url" type="string">
          LinkedIn profile URL of the connection
        </ResponseField>

        <ResponseField name="profile_picture" type="string">
          URL of the connection's profile picture (if available)
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="pagination" type="object">
      <Expandable title="Pagination Object">
        <ResponseField name="start_page" type="integer">
          Starting page number of the request
        </ResponseField>

        <ResponseField name="end_page" type="integer">
          Ending page number of the request
        </ResponseField>

        <ResponseField name="results_per_page" type="integer">
          Number of results per page
        </ResponseField>

        <ResponseField name="pages_fetched" type="integer">
          Number of pages successfully fetched
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "status": "success",
    "data": {
      "total_results": 20,
      "total_available_results": 839,
      "connections": [
        {
          "name": "Linda Källqvist",
          "job_title": "Planhat - VP Customer Success",
          "profile_url": "https://www.linkedin.com/in/lindakallqvist/",
          "profile_picture": "https://media.licdn.com/dms/image/v2/100_100/profile-displayphoto-shrink_100_100/0/1692692323766?e=1753920000&v=beta&t=HQ7CjvtZvsf7oq-tCtgJ82p5Px_oVf0HZlQtQLLjdMA"
        }
      ],
      "pagination": {
        "start_page": 1,
        "end_page": 2,
        "results_per_page": 10,
        "pages_fetched": 2
      }
    }
  }
  ```
</ResponseExample>

### Error Responses

<ResponseExample>
  ```json Insufficient Credits theme={null}
  {
    "status": "error",
    "message": "Insufficient credits available"
  }
  ```

  ```json Invalid Cookie theme={null}
  {
    "status": "error",
    "message": "Invalid or expired LinkedIn cookie"
  }
  ```
</ResponseExample>

### Notes

* The endpoint supports two modes of operation:
  1. Pagination mode: Specify both `start_page` and `end_page` to fetch specific pages
  2. Total results mode: Use `total_results` to specify the number of connections to fetch
* The profile picture URL may be 'N/A' if not available or if the connection has no profile picture
* The job title may be 'N/A' if the connection hasn't specified their current position
* When using pagination, `end_page` must be greater than or equal to `start_page`