Skip to Content
Prospecting data

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.

Prospecting data1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors
MarkdownOpenAPI

Headers

The endpoints on this page take these headers. Each endpoint's curl shows the ones it sends.

NameInTypeRequiredDescription
Ken-Versionheaderstring, one of: 2026-11-02, 1.1optionalThe 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-Idheaderinteger (int64)optionalThe 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

GET/v1/saved-list-memberssaved-list-members.list
Permission
Search view
Rate limit
12,000 requests a minute per API key
Needs the saved_lists feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

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: q is missing, shorter than 2 or longer than 200 characters, limit is out of range, or cursor is not a nextCursor from this search.
  • 429 quota_exceeded: the workspace used up its apiReadRows quota.

Requires Search view.

Parameters

NameInTypeRequiredDescription
qquerystringoptionalRequired. The text to find in a member's full name, title or company name, ignoring case. From 2 to 200 characters.
limitqueryinteger (int32)optionalMembers per page, from 1 to 100. Default 50.
cursorquerystringoptionalThe nextCursor from the previous page. Omit it for the first page.
Request
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.


On this page