nv.retrieveListLeads

Retrieve the leads in one of your Sales Navigator lead lists. For example, export a list to your CRM, or check who is in it before removing someone with nv.removeLeadFromList. Each lead's hashedUrl can be passed straight to nv.openPersonPage, nv.saveLead or nv.removeLeadFromList.

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

Constraints

⏺️ Root Start: allowed.

⬆️ Parent Actions: N/A.

⬇️ Child Actions: N/A.

Parameters

{
  "actionType": "nv.retrieveListLeads",
  "label": "emeaLeads",
  "listId": "7420000000000000001",
  "limit": 100
}

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

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

from linkedapi import NvRetrieveListLeadsParams

workflow = linkedapi.nv_retrieve_list_leads.execute(
    NvRetrieveListLeadsParams(
        list_id="7420000000000000001",
        limit=100,
    )
)

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

linkedin navigator lists leads 7420000000000000001 --limit 100 --json

In AI assistants, the MCP tool is nv_retrieve_list_leads. The n8n action is Retrieve list leads in Sales Navigator; the Make module is Retrieve List Leads in Sales Navigator.

Invalid parameters are rejected with invalidWorkflow before the workflow starts.

Reading behaviour

• Only your own lead lists. listId must be one of the lead lists nv.retrieveLists returns for you. An account 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. Leads are returned in the order the list shows them. Linked API reads the list 25 leads at a time until it has limit leads 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.searchPeople. Pass hashedUrl to nv.openPersonPage, nv.saveLead or nv.removeLeadFromList, or to filter.subjects in nv.retrieveAlerts.
• Recent changes can take tens of seconds to appear. Right after a lead 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.retrieveListLeads",
  "label": "emeaLeads",
  "success": true,
  "data": [
    {
      "name": "Jane Smith",
      "urn": "urn:li:member:123456789",
      "hashedUrl": "https://www.linkedin.com/in/SInQBmjJ015eLr8",
      "position": "Head of Sales",
      "companyName": "Example Labs",
      "location": "London, England, United Kingdom",
      "addedToListAt": "2026-10-30T09:00:00.000Z"
    },
    {
      "name": "Tom Brown",
      "urn": "urn:li:member:987654321",
      "hashedUrl": "https://www.linkedin.com/in/ACoAA2DdsSV83B48",
      "position": null,
      "companyName": null,
      "location": "Berlin, Germany",
      "addedToListAt": "2026-10-28T14:30:00.000Z"
    }
  ]
}

label is included only if specified in the action parameters.

Error result

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

{
  "actionType": "nv.retrieveListLeads",
  "label": "emeaLeads",
  "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 lead lists. This includes an account 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.