Docs
Get API key

Accounts

List LinkedIn accounts

GET/accounts

The workspace’s LinkedIn accounts, with the state the app shows (Sending, Waiting, Not sending, Limit reached, Paused, Disconnected), their limits and today’s use. Never their session, cookies or IP.

Try itSend a real request with your API key

Your key stays in this page and goes only to Salesteam.

Answer

200 OK Accounts.

  • dataarray of AccountRequired
    Each item
    • idstringRequired

      The account’s ID (accountId in GET /stats).

    • namestringRequired
    • headlinestringRequired
    • statusstringRequired

      One of connected, paused, disconnected.

    • stateobjectRequired

      What the account is doing now, as Salesteam’s LinkedIn accounts page says it.

      Inside it
      • keystringRequired

        One of sending, waiting, idle, limit, paused, disconnected.

      • labelstringRequired

        Sending, Waiting, Not sending, Limit reached, Paused or Disconnected.

      • detailstringRequired

        One line, like “3 of 25 invites today” or “Reconnect to resume”.

      • needsAttentionbooleanRequired

        Something only you can fix: a reconnect, or a pause to review.

    • activeCampaignsintegerRequired
    • limitsobjectRequired
      Inside it
      • connectionRequestsTodayintegerRequired

        Today’s allowance: lower than the daily limit while a newly connected account starts slow.

      • connectionRequestsPerDayintegerRequired
      • connectionRequestsPerWeekintegerRequired
      • messagesPerDayintegerRequired
      • inmailsPerDayintegerRequired
      • profileViewsPerDayintegerRequired
      • likesPerDayintegerRequired
      • followsPerDayintegerRequired
    • todayobjectRequired

      Sent today, in the account’s time zone.

      Inside it
      • connectionRequestsintegerRequired
      • messagesintegerRequired
      • inmailsintegerRequired
      • profileViewsintegerRequired
      • likesintegerRequired
      • followsintegerRequired
    • connectionRequestsThisWeekintegerRequired
    • workingHoursobjectRequired
      Inside it
      • timezonestringRequired
      • startintegerRequired

        Hour, 0–23.

      • endintegerRequired
      • weekdaysarray of integerRequired

        0 is Sunday.

    • connectedAtstring · date-timeRequired
    • disconnectedAtstring · date-time or nullRequired
  • nextCursorstring or nullRequired

    Pass as cursor for the next page; null on the last page.

Errors

  • 401 Unauthorizedunauthorized
  • 429 Too many requestsrate_limited
  • 500 Server errorserver_error

Every error has the same shape. See Errors.

GET /accounts
curl "https://app.salesteam.dev/api/v1/accounts" \
  -H "Authorization: Bearer $SALESTEAM_API_KEY"
200 answer
{
  "data": [
    {
      "id": "acc_7Qm2xT9a",
      "name": "Founders Q4",
      "headline": "Head of Sales at Pear Sky",
      "status": "connected",
      "state": {
        "key": "sending",
        "label": "label",
        "detail": "detail",
        "needsAttention": true
      },
      "activeCampaigns": 1,
      "limits": {
        "connectionRequestsToday": 1,
        "connectionRequestsPerDay": 1,
        "connectionRequestsPerWeek": 1,
        "messagesPerDay": 1,
        "inmailsPerDay": 1,
        "profileViewsPerDay": 1,
        "likesPerDay": 1,
        "followsPerDay": 1
      },
      "today": {
        "connectionRequests": 1,
        "messages": 1,
        "inmails": 1,
        "profileViews": 1,
        "likes": 1,
        "follows": 1
      },
      "connectionRequestsThisWeek": 1,
      "workingHours": {
        "timezone": "timezone",
        "start": 1,
        "end": 1,
        "weekdays": [
          1
        ]
      },
      "connectedAt": "2026-11-12T09:00:00.000Z",
      "disconnectedAt": "2026-11-12T09:00:00.000Z"
    }
  ],
  "nextCursor": null
}