List Accounts

List all accounts associated with your API key

GET /v2/accounts

List Accounts

cURL

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

Success 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"
        }
      },
      {
        "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 }
      }
    ],
    "total": 1247,
    "limit": 50,
    "offset": 0
  },
  "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

x-api-key · string · required

Your API key

Query Parameters

count · integer · default: "50"

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

offset · integer · default: "0"

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

Response

success · boolean

Whether the request was successful

data · object

Show Properties

items · array

Show Account Object

account_id · string

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

platform · string

Platform type (e.g. “linkedin”)

account_name · string

Display name of the account

is_active · boolean

Whether the account is currently active and usable

status · 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

checkpoint_type · string

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

sent_to · string

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

country · string

Country code associated with the account

created_at · string

ISO 8601 timestamp of when the account was created

updated_at · string

ISO 8601 timestamp of the last account update

sales_nav · object

State of the account’s Sales Nav seat.

Show sales_nav properties

connected · boolean

Whether the account currently has a usable Sales Nav seat.

contract_id · string

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

seat_id · string

The seat within that contract.

connected_at · string

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

reason · string

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

disconnected_at · string

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

total · integer

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

limit · integer

The limit used for this request

offset · integer

The offset used for this request

metadata · object

Show Properties

action · string

The action performed (“list_accounts”)

credits_consumed · integer

Always 0 — this endpoint is free

timestamp · string

ISO 8601 timestamp of the response

Success 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"
        }
      },
      {
        "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 }
      }
    ],
    "total": 1247,
    "limit": 50,
    "offset": 0
  },
  "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 }

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