List Accounts

curl --request GET \
  --url https://api.linkupapi.com/v2/accounts \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.linkupapi.com/v2/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkupapi.com/v2/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkupapi.com/v2/accounts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/accounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "items": [
      {
        "account_id": "acc_abc123",
        "platform": "linkedin",
        "account_name": "John Doe",
        "is_active": true,
        "status": "connected",
        "country": "FR",
        "created_at": "2025-10-15T08:30:00Z",
        "updated_at": "2026-03-20T14:22:00Z",
        "sales_nav": {
          "connected": true,
          "contract_id": "2016220713",
          "seat_id": "1545550052",
          "connected_at": "2026-03-20T14:22:00Z"
        },
        "recruiter": {
          "connected": true,
          "contract_id": "2064790365",
          "seat_id": "1612889193",
          "connected_at": "2026-03-21T09:00:00Z"
        },
        "proxy": { "mode": "managed" }
      },
      {
        "account_id": "acc_def456",
        "platform": "linkedin",
        "account_name": "Jane Smith",
        "is_active": false,
        "status": "disconnected",
        "country": "US",
        "created_at": "2025-11-01T12:00:00Z",
        "updated_at": "2026-02-10T09:15:00Z",
        "sales_nav": { "connected": false },
        "recruiter": { "connected": false },
        "proxy": { "mode": "managed" }
      }
    ],
    "total": 1247,
    "limit": 50,
    "offset": 0
  },
  "metadata": {
    "action": "list_accounts",
    "credits_consumed": 0,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}

// seat live
"sales_nav": { "connected": true, "contract_id": "2016220713", "seat_id": "1545550052", "connected_at": "2026-07-28T10:13:12Z" }

// licence lost, LinkedIn account still fine
"sales_nav": { "connected": false, "reason": "No Sales Nav license found for this account", "disconnected_at": "2026-07-28T10:12:25Z" }

// LinkedIn account disconnected
"sales_nav": { "connected": false, "reason": "LinkedIn account is disconnected — reconnect it to restore the Sales Nav seat", "contract_id": "2016220713", "seat_id": "1545550052" }

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API Key"
  },
  "metadata": {
    "action": "list_accounts",
    "credits_consumed": 0,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}

GET

accounts

List Accounts

curl --request GET \
  --url https://api.linkupapi.com/v2/accounts \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.linkupapi.com/v2/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.linkupapi.com/v2/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.linkupapi.com/v2/accounts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.linkupapi.com/v2/accounts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "items": [
      {
        "account_id": "acc_abc123",
        "platform": "linkedin",
        "account_name": "John Doe",
        "is_active": true,
        "status": "connected",
        "country": "FR",
        "created_at": "2025-10-15T08:30:00Z",
        "updated_at": "2026-03-20T14:22:00Z",
        "sales_nav": {
          "connected": true,
          "contract_id": "2016220713",
          "seat_id": "1545550052",
          "connected_at": "2026-03-20T14:22:00Z"
        },
        "recruiter": {
          "connected": true,
          "contract_id": "2064790365",
          "seat_id": "1612889193",
          "connected_at": "2026-03-21T09:00:00Z"
        },
        "proxy": { "mode": "managed" }
      },
      {
        "account_id": "acc_def456",
        "platform": "linkedin",
        "account_name": "Jane Smith",
        "is_active": false,
        "status": "disconnected",
        "country": "US",
        "created_at": "2025-11-01T12:00:00Z",
        "updated_at": "2026-02-10T09:15:00Z",
        "sales_nav": { "connected": false },
        "recruiter": { "connected": false },
        "proxy": { "mode": "managed" }
      }
    ],
    "total": 1247,
    "limit": 50,
    "offset": 0
  },
  "metadata": {
    "action": "list_accounts",
    "credits_consumed": 0,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}

// seat live
"sales_nav": { "connected": true, "contract_id": "2016220713", "seat_id": "1545550052", "connected_at": "2026-07-28T10:13:12Z" }

// licence lost, LinkedIn account still fine
"sales_nav": { "connected": false, "reason": "No Sales Nav license found for this account", "disconnected_at": "2026-07-28T10:12:25Z" }

// LinkedIn account disconnected
"sales_nav": { "connected": false, "reason": "LinkedIn account is disconnected — reconnect it to restore the Sales Nav seat", "contract_id": "2016220713", "seat_id": "1545550052" }

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API Key"
  },
  "metadata": {
    "action": "list_accounts",
    "credits_consumed": 0,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}

Retrieve a paginated list of accounts linked to your API key. Use the returned account_id values in all subsequent V2 action requests.

This endpoint is free — it does not consume any credits.

Header Parameters

string

required

Your API key

Query Parameters

integer

default:"50"

Maximum number of accounts to return per page (1-500).

integer

default:"0"

Number of accounts to skip — use with limit to paginate (e.g. offset=50&limit=50 for page 2).

Response

boolean

Whether the request was successful

object

Show Properties

array

Show Account Object

string

Unique identifier for the account (use this in action requests)

string

Platform type (e.g. “linkedin”)

string

Display name of the account

boolean

Whether the account is currently active and usable

string

Account status, always in step with is_active:

connected — ready to use (is_active: true)
checkpoint_required — waiting on a 2FA code, see Checkpoint
disconnected — the LinkedIn session expired; re-authenticate via Connect Account

string

Where the code went, when checkpoint_required: email, sms, authenticator_app, app_approval or code.

string

Masked destination when LinkedIn shows it, e.g. phone number ending with 23.

string

Country code associated with the account

string

ISO 8601 timestamp of when the account was created

string

ISO 8601 timestamp of the last account update

object

State of the account’s Sales Nav seat.

Show sales_nav properties

boolean

Whether the account currently has a usable Sales Nav seat.

string

Sales Nav contract the seat belongs to. Present once a seat has been activated.

string

The seat within that contract.

string

ISO 8601 timestamp of the last seat activation or refresh. Only when connected is true.

string

Why the seat is unavailable. Only when connected is false and a seat existed before.

string

ISO 8601 timestamp of when the seat was lost. Only when the seat died on its own.

object

LinkedIn accounts only. State of the account’s Recruiter seat — { "connected": false } when there is none. Same fields as sales_nav. Recruiter actions use this account’s account_id (see Recruiter seat).

object

{ "mode": "managed" } or { "mode": "custom", "host": "...", "port": 8080 } — see Set Custom Proxy. LinkedIn accounts only.

integer

Total number of accounts matching the query (across all pages)

integer

The limit used for this request

integer

The offset used for this request

object

Show Properties

string

The action performed (“list_accounts”)

integer

Always 0 — this endpoint is free

string

ISO 8601 timestamp of the response

{
  "success": true,
  "data": {
    "items": [
      {
        "account_id": "acc_abc123",
        "platform": "linkedin",
        "account_name": "John Doe",
        "is_active": true,
        "status": "connected",
        "country": "FR",
        "created_at": "2025-10-15T08:30:00Z",
        "updated_at": "2026-03-20T14:22:00Z",
        "sales_nav": {
          "connected": true,
          "contract_id": "2016220713",
          "seat_id": "1545550052",
          "connected_at": "2026-03-20T14:22:00Z"
        },
        "recruiter": {
          "connected": true,
          "contract_id": "2064790365",
          "seat_id": "1612889193",
          "connected_at": "2026-03-21T09:00:00Z"
        },
        "proxy": { "mode": "managed" }
      },
      {
        "account_id": "acc_def456",
        "platform": "linkedin",
        "account_name": "Jane Smith",
        "is_active": false,
        "status": "disconnected",
        "country": "US",
        "created_at": "2025-11-01T12:00:00Z",
        "updated_at": "2026-02-10T09:15:00Z",
        "sales_nav": { "connected": false },
        "recruiter": { "connected": false },
        "proxy": { "mode": "managed" }
      }
    ],
    "total": 1247,
    "limit": 50,
    "offset": 0
  },
  "metadata": {
    "action": "list_accounts",
    "credits_consumed": 0,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}

// seat live
"sales_nav": { "connected": true, "contract_id": "2016220713", "seat_id": "1545550052", "connected_at": "2026-07-28T10:13:12Z" }

// licence lost, LinkedIn account still fine
"sales_nav": { "connected": false, "reason": "No Sales Nav license found for this account", "disconnected_at": "2026-07-28T10:12:25Z" }

// LinkedIn account disconnected
"sales_nav": { "connected": false, "reason": "LinkedIn account is disconnected — reconnect it to restore the Sales Nav seat", "contract_id": "2016220713", "seat_id": "1545550052" }

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API Key"
  },
  "metadata": {
    "action": "list_accounts",
    "credits_consumed": 0,
    "timestamp": "2026-04-28T12:00:00Z"
  }
}

Sales Nav seat

Whether the account can run lead searches, send InMails and read its InMail balance. The seat is derived from the LinkedIn session, so:

account disconnects → seat goes with it; reconnecting restores it
seat can die alone (expired licence, seat reassigned) → is_active stays true, connected turns false with a reason
never had Sales Nav → just { "connected": false }

Recruiter seat

recruiter on the LinkedIn account tells whether its Recruiter seat is connected. Recruiter actions use the account’s own account_id (see Recruiter seat).

several contracts → contracts, with selected on the current one (same in sales_nav)
the seat and the account disconnect independently
no seat → "recruiter": { "connected": false }

Notes

Use the account_id from the response in all V2 action requests
Only accounts with is_active: true can be used for actions
Results are sorted by created_at descending (newest first)
Default page size is 50; the maximum allowed limit is 500. To page through all accounts, increment offset by limit until offset + limit >= total

Getting Started

Accounts

Profiles

Messaging

Network

Content

Recruiting

Credits

Logs

Email Enrichment

Webhooks (Real-Time)

List Accounts

Header Parameters

Query Parameters

Response

Sales Nav seat

Recruiter seat

Notes

​Header Parameters

​Query Parameters

​Response

​Sales Nav seat

​Recruiter seat

​Notes

Header Parameters

Query Parameters

Response

Sales Nav seat

Recruiter seat

Notes