Saved list members
Saved lists are reusable lists of people or companies that a workspace builds from Search, saved searches, campaigns, other lists and CSV uploads. Create and copy a list, add sources that fill it in the background and refresh them, and read or remove its members, or search members across every list at once. Share a list read-only with another workspace by email invite and revoke the grant later, or submit it to the Kenso library, where every workspace can read and copy the lists Kenso approves. A member never carries an email address or a phone number, only how many the list holds. A list the workspace cannot read answers 404 not_found, and a private list is visible only to the member who owns it.
Headers
The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Ken-Version | header | string, one of: 2026-11-02, 1.1 | optional | The API version, a date in YYYY-MM-DD form. 1.1 is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and 404 where the path exists only in this version. A date that is not a version answers 400 unsupported_version; any other value that is not a version is treated as legacy. |
X-Ken-Workspace-Id | header | integer (int64) | optional | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers 400 workspace_required. A workspace you are not a member of answers 404 not_found. |
Search members across saved lists
/v1/saved-list-memberssaved-list-members.list- Permission
- Search view
- Rate limit
- 12,000 requests a minute per API key
saved_lists feature on your workspace. Until it is on, calls answer 404.Finds people and companies on the workspace's saved lists by name, title or company, across every list at once.
q is required, from 2 to 200 characters, and matches part of a member's full name, title or company name, in any case. Kenso searches the workspace's own lists (a private list only for its owner) and the lists shared with it through an accepted invite, never library lists. Hits come in list id order, then member id order.
Each hit is a member as GET /v1/saved-lists/{savedListId}/members returns it, with no email address or phone number, plus savedListId, savedListName and savedListKind. A person on two lists is two hits, each with that list's member id. Members who opted out never appear.
limit is from 1 to 100 (default 50), and cursor takes the previous page's nextCursor with the same q. The response has no total. Each request reads at most 50,000 members per list owner, so a rare q over large lists can return a short page, or an empty one, with hasMore true. Keep paging with nextCursor until hasMore is false.
Each hit returned counts as one row of the workspace's apiReadRows quota.
Errors:
400 validation_failed:qis missing, shorter than 2 or longer than 200 characters,limitis out of range, orcursoris not anextCursorfrom this search.429 quota_exceeded: the workspace used up itsapiReadRowsquota.
Requires Search view.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
q | query | string | optional | Required. The text to find in a member's full name, title or company name, ignoring case. From 2 to 200 characters. |
limit | query | integer (int32) | optional | Members per page, from 1 to 100. Default 50. |
cursor | query | string | optional | The nextCursor from the previous page. Omit it for the first page. |
curl -X GET "https://api.ken.so/v1/saved-list-members?limit=50" \
-H "Authorization: Bearer $KENSO_API_KEY" \
-H "Ken-Version: 2026-11-02" \
-H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"Response 200
data is a list of SavedListMemberMatch. Each item has these fields. The response also carries pagination.
Show the 23 response fields and an example
The fields and an example are also on this endpoint's Markdown page.
More in Prospecting data:People and company searchSaved searchesSaved listsSaved list invitesEmail finderFunding roundsJob postingsJob post searchLinkedIn job searchLinkedIn jobsWeb scrapingSocial data lookupsSocial data searchesSocial profile resolutionSocial data recordsSignalsAll resources