Kenso
Get early access

Saved list members

The Saved list members endpoints of the Kenso API.

1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors

Search members across the workspace's saved lists

GET/v1/saved-list-memberssaved-list-members.list

Needs the saved_lists feature on your workspace. Until it is on, calls answer 404.

Try it on developer.ken.so

q (required, 2-200 characters) matches a part of a member's full name, title or company name, any case. Searches the workspace's own lists (a private list only for its owner) and lists shared with it through an accepted invite; never library lists. Hits come ordered by list id, then member id. Each hit has the member fields of the list-members route (never an email or a phone: emailCount and phoneCount instead) plus savedListId, savedListName and savedListKind (people or companies). A person on two lists is two hits, one per list, each with that list's member id. Opted-out members never show. limit 1-100 (default 50); cursor is the previous page's nextCursor. No total. Each request examines a bounded number of members (50,000 per list owner), so with a rare q over large lists a page can hold fewer than limit hits, even none, with hasMore true: keep paging with nextCursor. Each hit returned counts one row of the workspace's apiReadRows quota; past it, 429 quota_exceeded. Requires the Search page (view).

Parameters

Name
In
Type
Required
Description
Q
In: query
string
optional
Required, 2 to 200 characters: a part of the full name, the title or the company name, any case.
Limit
In: query
integer (int32)
optional
1 to 100, default 50.
Cursor
In: query
string
optional
The previous page's nextCursor.
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.
X-Ken-Workspace-Id
In: header
integer (int64)
optional
Workspace to act in. Required when your credential can reach more than one workspace (otherwise 400 workspace_required).

Response 200

data is a list of SavedListMemberMatchModel. Each item has these fields. The response also carries pagination.

Field
Type
Description
id
integer (int64)
identityKey
string
firstName
string
lastName
string
title
string
seniority
string
companyName
string
companyDomain
string
industry
string
headcountBand
string
country
string
state
string
city
string
linkedinUrl
string
hasSendableEmail
boolean
emailCount
integer (int32)
phoneCount
integer (int32)
sources
array of string
custom
map of string
savedListId
integer (int64)
savedListName
string
savedListKind
string, one of: people, companies
Request
curl -X GET "https://api.ken.so/v1/saved-list-members" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KEN_WORKSPACE_ID"
Response 200
{
  "success": true,
  "data": [
    {
      "id": 812,
      "identityKey": "string",
      "firstName": "string",
      "lastName": "string",
      "title": "string",
      "seniority": "string",
      "companyName": "string",
      "companyDomain": "example.com",
      "industry": "string",
      "headcountBand": "string",
      "country": "string",
      "state": "string",
      "city": "string",
      "linkedinUrl": "https://example.com",
      "hasSendableEmail": true,
      "emailCount": 1,
      "phoneCount": 1,
      "sources": [
        "string"
      ],
      "custom": {
        "key": "string"
      },
      "savedListId": 812,
      "savedListName": "string",
      "savedListKind": "people"
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6ODE1fQ",
    "hasMore": true,
    "total": 1,
    "isTotalCapped": true
  }
}