List Connections

Retrieve a paginated list of connections.

POST /v2/network

List Connections

cURL

curl --request POST \
  --url https://api.linkupapi.com/v2/network \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "account_id": "<string>",
  "action": "<string>",
  "params": {
    "count": 123,
    "offset": 123,
    "use_cache": true
  }
}
'

200

{
  "success": true,
  "data": {
    "connections": [
      {
        "name": "Jane Doe",
        "job_title": "Founder @ Acme Corp — AI recruiting platform",
        "profile_url": "https://www.linkedin.com/in/jane-doe-42/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
        "member_urn": "urn:li:fsd_profile:ACoAABxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx1"
      }
    ],
    "total_results": 1,
    "total_available_results": 1201,
    "pagination": {
      "offset": 0,
      "count": 1,
      "next_offset": 1,
      "has_more": true,
      "results_per_page": 10,
      "pages_fetched": 1
    }
  },
  "metadata": {
    "action": "list_connections",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}

Overview

Returns a paginated list of the account’s connections. Pagination is offset-based (the platform provides a stable, addressable list — no opaque cursor needed). Set count for the page size and offset to skip ahead.

This endpoint consumes 1 credit per 50 results returned. The platform returns up to 100 connections per internal request, so requesting count: 250 triggers ~3 upstream calls automatically. Ignore this if you’re on per-seat pricing: usage is unlimited.

Is one profile a connection?

Same stored copy, one profile: send action: "check_connection" with params.profile_url (full URL or public identifier). Returns connected: true/false, name, cache_synced and cache_synced_at. 0 credit, no LinkedIn traffic.

{ "account_id": "your-account-id", "action": "check_connection", "params": { "profile_url": "https://www.linkedin.com/in/jane-doe-42/" } }

Request

x-api-key · string · required

Your API key for authentication.

account_id · string · required

The unique identifier of the account to use.

action · string · required

Must be "list_connections".

params · object

Show params properties

count · integer · default: 10

Number of connections to return. Defaults to 10. Capped at 1000 per call — to retrieve more, paginate with offset.

offset · integer · default: 0

Zero-indexed offset into the connections list. Defaults to 0. Use pagination.next_offset from a previous response to fetch the next page.

use_cache · boolean · default: false

Serve the list from our stored copy of the account’s connections instead of LinkedIn: 0 credit, no LinkedIn traffic, newest connection first. The copy exists for accounts subscribed to the accepted_invitation webhook event (full sync at subscription, then every detected acceptance is added). Without it the response is empty with cache_synced: false.

Response

success · boolean

Indicates whether the request was successful.

data · object

Show data properties

connections · array

List of connection objects.

Show connection properties

name · string

Display name of the connection.

job_title · string

Headline / current job title.

profile_url · string

Public profile URL.

profile_picture · string

URL of the connection’s profile picture.

member_urn · string

Member URN (urn:li:fsd_profile:ACoA…), the id invite accepts. Not returned with use_cache.

total_results · integer

Number of connections returned in this response.

total_available_results · integer

Total number of connections available in the account.

source · string

"cache" when served with use_cache. Absent otherwise.

cache_synced · boolean

With use_cache only: false when the account has no stored copy yet.

cache_synced_at · string

With use_cache only: ISO 8601 date of the most recent stored connection.

pagination · object

Show pagination properties

offset · integer

Offset of the first connection in this response.

count · integer

Number of connections returned (mirrors total_results).

next_offset · integer

Offset to send as offset in the next request to fetch the next page. null when there are no more results.

has_more · boolean

true if more connections are available beyond this batch.

results_per_page · integer

Maximum batch size used per upstream request.

pages_fetched · integer

Number of internal upstream batches consumed to assemble this response.

metadata · object

Show metadata properties

action · string

The action that was performed ("list_connections").

account_id · string

The account ID used for the request.

credits_consumed · integer

Number of credits consumed (1 per 50 results).

timestamp · string

ISO 8601 timestamp of the response.

200

{
  "success": true,
  "data": {
    "connections": [
      {
        "name": "Jane Doe",
        "job_title": "Founder @ Acme Corp — AI recruiting platform",
        "profile_url": "https://www.linkedin.com/in/jane-doe-42/",
        "profile_picture": "https://media.licdn.com/dms/image/v2/.../profile.jpg",
        "member_urn": "urn:li:fsd_profile:ACoAABxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx1"
      }
    ],
    "total_results": 1,
    "total_available_results": 1201,
    "pagination": {
      "offset": 0,
      "count": 1,
      "next_offset": 1,
      "has_more": true,
      "results_per_page": 10,
      "pages_fetched": 1
    }
  },
  "metadata": {
    "action": "list_connections",
    "account_id": "your-account-id",
    "credits_consumed": 1,
    "timestamp": "2026-04-26T10:35:00Z"
  }
}