nv.retrieveListAccounts

Retrieve the accounts in one of your Sales Navigator account lists. For example, export a list to your CRM, or check which companies are in it before removing one with nv.removeAccountFromList. Each account's hashedUrl can be passed straight to nv.openCompanyPage, nv.saveAccount or nv.removeAccountFromList.

An active Sales Navigator subscription is required. To find a list's ID, call nv.retrieveLists with type set to account. For the people in a lead list, use nv.retrieveListLeads.

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.retrieveListAccounts",
  "label": "targetAccounts",
  "listId": "7420000000000000003",
  "limit": 100
}

const workflow = await linkedapi.nvRetrieveListAccounts.execute({
  listId: "7420000000000000003",
  limit: 100
});

const { data, errors } = await linkedapi.nvRetrieveListAccounts.result(workflow.workflowId);

from linkedapi import NvRetrieveListAccountsParams

workflow = linkedapi.nv_retrieve_list_accounts.execute(
    NvRetrieveListAccountsParams(
        list_id="7420000000000000003",
        limit=100,
    )
)

result = linkedapi.nv_retrieve_list_accounts.result(workflow.workflow_id)

linkedin navigator lists accounts 7420000000000000003 --limit 100 --json

In AI assistants, the MCP tool is nv_retrieve_list_accounts. The n8n action is Retrieve list accounts in Sales Navigator; the Make module is Retrieve List Accounts in Sales Navigator.

Invalid parameters are rejected with invalidWorkflow before the workflow starts.

Reading behaviour

• Only your own account lists. listId must be one of the account lists nv.retrieveLists returns for you. A lead list's ID, a list someone else shared with you, or an ID that is not one of your lists fails with listNotFound.
• In Sales Navigator's order, up to limit. Accounts are returned in the order the list shows them. Linked API reads the list 25 accounts at a time until it has limit accounts or reaches the end of the list. An empty list returns an empty array.
• Ready for other actions. urn and hashedUrl have the same form as in nv.searchCompanies. Pass hashedUrl to nv.openCompanyPage, nv.saveAccount or nv.removeAccountFromList, or to filter.subjects in nv.retrieveAlerts.
• Recent changes can take tens of seconds to appear. Right after an account is added to or removed from the list, this action can still return the list as it was. Read it again a little later.
• A list that changes while it is read. If the list changes between two of its pages, the call fails with unexpectedError rather than returning a partial or repeated list. Call it again.

Result options

{
  "actionType": "nv.retrieveListAccounts",
  "label": "targetAccounts",
  "success": true,
  "data": [
    {
      "name": "TechCorp",
      "urn": "urn:li:organization:12345678",
      "hashedUrl": "https://www.linkedin.com/company/12345678",
      "industry": "IT Services and IT Consulting",
      "employeesCount": 500
    },
    {
      "name": "Example Labs",
      "urn": "urn:li:organization:87654321",
      "hashedUrl": "https://www.linkedin.com/company/87654321",
      "industry": null,
      "employeesCount": null
    }
  ]
}

label is included only if specified in the action parameters.

Error result

An unsuccessful action returns success: false with an error object:

{
  "actionType": "nv.retrieveListAccounts",
  "label": "targetAccounts",
  "success": false,
  "error": {
    "type": "listNotFound",
    "message": "The list is not available for this subject in Sales Navigator."
  }
}

Possible error.type values:

• noSalesNavigator — the account does not have an active Sales Navigator subscription.
• listNotFound — listId is not one of your account lists. This includes a lead list's ID and a list someone else shared with you.
• unexpectedError — the list could not be read, for example because it changed while it was being read. Call it again.