On this page

GET/accounts

Purpose

Connected LinkedIn accounts (for accountId on search / lookup / send).


Request

GET /accounts?limit=50
X-API-Key: sk_live_...
QueryNotes
limit1–100, default 50
cursornextCursor from the previous page. An unknown cursor is 400

Response 200

{
  "accounts": [
    {
      "id": "acc_abc",
      "name": "Jane Doe",
      "status": "connected",
      "active": true,
      "hasSalesNavigator": false,
      "connectionInviteNoteCharCap": 200,
      "connectionInviteNotePausedUntil": null,
      "connectionInviteNotePausedReason": null,
      "today": {
        "connectionRequestsSent": 12,
        "connectionRequestsAccepted": 3,
        "connectionRequestLimit": 20,
        "messagesSent": 8,
        "messageLimit": 20
      }
    }
  ],
  "nextCursor": null
}

Follow nextCursor until it is null. Most workspaces fit in a single page.

statusMeaning
connectedUsable
connectingIn progress
failedError state
disconnectedNot usable

today counters are for the current UTC day.

hasSalesNavigator is true only when a Sales Navigator contract id is stored. LinkedIn Premium alone is false. Use type: classic unless it is true.

connectionInviteNoteCharCap is 200 (free) or 300 (Premium). When connectionInviteNotePausedUntil is set, invites still send but without a note until that time (or until the user resumes notes in the ScaliQ Accounts UI). connectionInviteNotePausedReason is typically provider_note_quota while paused.


MCP

Tool: list_accounts.