> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkupapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Accounts

> List all accounts associated with your API key

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

<Note>
  This endpoint is **free** — it does not consume any credits.
</Note>

### Header Parameters

<ParamField header="x-api-key" type="string" required>
  Your API key
</ParamField>

### Query Parameters

<ParamField query="count" type="integer" default="50">
  Maximum number of accounts to return per page (1-500).
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of accounts to skip — use with `limit` to paginate (e.g. `offset=50&limit=50` for page 2).
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Whether the request was successful
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Properties">
    <ResponseField name="items" type="array">
      <Expandable title="Account Object">
        <ResponseField name="account_id" type="string">
          Unique identifier for the account (use this in action requests)
        </ResponseField>

        <ResponseField name="platform" type="string">
          Platform type (e.g. "linkedin")
        </ResponseField>

        <ResponseField name="account_name" type="string">
          Display name of the account
        </ResponseField>

        <ResponseField name="is_active" type="boolean">
          Whether the account is currently active and usable
        </ResponseField>

        <ResponseField name="status" type="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](/api-reference/v2/accounts/checkpoint)
          * `disconnected` — the LinkedIn session expired; re-authenticate via [Connect Account](/api-reference/v2/accounts/login)
        </ResponseField>

        <ResponseField name="checkpoint_type" type="string">
          Where the code went, when `checkpoint_required`: `email`, `sms`, `authenticator_app`, `app_approval` or `code`.
        </ResponseField>

        <ResponseField name="sent_to" type="string">
          Masked destination when LinkedIn shows it, e.g. `phone number ending with 23`.
        </ResponseField>

        <ResponseField name="country" type="string">
          Country code associated with the account
        </ResponseField>

        <ResponseField name="created_at" type="string">
          ISO 8601 timestamp of when the account was created
        </ResponseField>

        <ResponseField name="updated_at" type="string">
          ISO 8601 timestamp of the last account update
        </ResponseField>

        <ResponseField name="sales_nav" type="object">
          State of the account's Sales Nav seat.

          <Expandable title="sales_nav properties">
            <ResponseField name="connected" type="boolean">
              Whether the account currently has a usable Sales Nav seat.
            </ResponseField>

            <ResponseField name="contract_id" type="string">
              Sales Nav contract the seat belongs to. Present once a seat has been activated.
            </ResponseField>

            <ResponseField name="seat_id" type="string">
              The seat within that contract.
            </ResponseField>

            <ResponseField name="connected_at" type="string">
              ISO 8601 timestamp of the last seat activation or refresh. Only when `connected` is `true`.
            </ResponseField>

            <ResponseField name="reason" type="string">
              Why the seat is unavailable. Only when `connected` is `false` and a seat existed before.
            </ResponseField>

            <ResponseField name="disconnected_at" type="string">
              ISO 8601 timestamp of when the seat was lost. Only when the seat died on its own.
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="total" type="integer">
      Total number of accounts matching the query (across all pages)
    </ResponseField>

    <ResponseField name="limit" type="integer">
      The `limit` used for this request
    </ResponseField>

    <ResponseField name="offset" type="integer">
      The `offset` used for this request
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  <Expandable title="Properties">
    <ResponseField name="action" type="string">
      The action performed ("list\_accounts")
    </ResponseField>

    <ResponseField name="credits_consumed" type="integer">
      Always `0` — this endpoint is free
    </ResponseField>

    <ResponseField name="timestamp" type="string">
      ISO 8601 timestamp of the response
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "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"
    }
  }
  ```

  ```json Sales Nav states theme={null}
  // 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" }
  ```

  ```json Error Response theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_API_KEY",
      "message": "The provided API key is invalid or missing"
    },
    "metadata": {
      "action": "list_accounts",
      "credits_consumed": 0,
      "timestamp": "2026-04-28T12:00:00Z"
    }
  }
  ```
</ResponseExample>

### Sales Nav seat

Whether the account can run [lead searches](/api-reference/v2/profiles/search-people-nav), send InMails and read its [InMail balance](/api-reference/v2/messages/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`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.