List a list's rows
get_list_rowsUse this when the user wants to see who or what is on a list. Returns one page of its rows, people in a people list and companies in a company list, with job, company, and the email addresses and phone numbers already saved. Narrow the rows with filters, order them with sortBy, and for the next page send the page's next cursor with the same filters and sort. Free. It reads what is saved: it does not look up missing email addresses or phone numbers.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"listId": "<listId>"
},
"name": "get_list_rows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | The `pagination.nextCursor` of the page before. Later pages keep the first page's size. | |
| detail | No | How much of each row to return. `short` (the default) leaves out the long fields; `full` returns every field, so ask for few rows with it. | short |
| listId | Yes | The list's id. | |
| sortBy | No | The field to sort by. People lists: `firstName`, `lastName`, `jobTitle`, `createdAt`, `address.city`, `address.country`, a company field such as `company.name` or `company.linkedInHeadCount`, or `customColumns_<columnId>`. Company lists: `name`, `domain`, `industry`, `revenue`, `linkedInHeadCount` or `customColumns_<columnId>`. A field it does not know keeps the list's own order. | |
| filters | No | Only the rows that match: a JSON object written as a string, at most 8,000 characters. A row must match every key, and any of a key's values. Text keys take an array of values or {"include": [...], "exclude": [...]}: name, title, dept, level, industryName, country, state, personalLocation, companyName, companyIndustry, companyHeadQuartersCountry, companyLocation, website, campaignEngagement and otherLists (names of other lists). numberOfEmployees takes ranges as strings, such as "51-200" or "10001+". keywords (a job title, with * and ? as wildcards) and linkedinUrl take one string. enrichedEmail (enriched, not_enriched, no_emails_found), enrichedPhone (enriched, not_enriched) and emailValidity (valid, invalid, catch-all, unknown, do_not_mail, personal, unverified) take {"include": [...]} or {"exclude": [...]}. icpMatch takes ["yes"] or ["no"]. Company lists take companyName, companyIndustry, companyHeadQuartersCountry, website, numberOfEmployees and campaignEngagement. | |
| pageSize | No | Rows per page. | |
| sortOrder | No | The order `sortBy` sorts in. | asc |