List Saved Searches
curl --request GET \
--url https://api.lemlist.com/api/database/saved-searches \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/database/saved-searches"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/database/saved-searches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/database/saved-searches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/database/saved-searches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": [
{
"_id": "lss_ExAmPlE4f7Kq2Wz9x",
"name": "Paris SaaS founders",
"mode": "leads",
"filters": [
{
"filterId": "currentTitle",
"in": [
"Founder"
],
"out": []
},
{
"filterId": "country",
"in": [
"France"
],
"out": []
}
],
"createdAt": "2026-09-14T08:30:00.000Z",
"lastResultsCount": 1240,
"lastResultsCountUpdatedAt": "2026-09-14T08:30:00.000Z"
}
]
}{
"error": "Parameter mode is invalid",
"code": "API_INVALID_MODE"
}The authentication you supplied is incorrect{
"error": "Route bad method",
"code": "ROUTE_BAD_METHOD"
}People database
List Saved Searches
Retrieves the People Database saved searches of your team.
GET
/
database
/
saved-searches
List Saved Searches
curl --request GET \
--url https://api.lemlist.com/api/database/saved-searches \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://api.lemlist.com/api/database/saved-searches"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://api.lemlist.com/api/database/saved-searches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://api.lemlist.com/api/database/saved-searches")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.lemlist.com/api/database/saved-searches",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"data": [
{
"_id": "lss_ExAmPlE4f7Kq2Wz9x",
"name": "Paris SaaS founders",
"mode": "leads",
"filters": [
{
"filterId": "currentTitle",
"in": [
"Founder"
],
"out": []
},
{
"filterId": "country",
"in": [
"France"
],
"out": []
}
],
"createdAt": "2026-09-14T08:30:00.000Z",
"lastResultsCount": 1240,
"lastResultsCountUpdatedAt": "2026-09-14T08:30:00.000Z"
}
]
}{
"error": "Parameter mode is invalid",
"code": "API_INVALID_MODE"
}The authentication you supplied is incorrect{
"error": "Route bad method",
"code": "ROUTE_BAD_METHOD"
}Saved searches are team-shared: every member sees the same list. Results are sorted by name. Use
mode to restrict the list to one search mode — saved searches created before modes existed are returned for both.Authorizations
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Query Parameters
Restrict the list to saved searches of one search mode. Saved searches created before modes existed are returned for both modes. Omit to return every saved search of the team.
Available options:
leads, companies Response
Success
The team's saved searches, sorted by name
Show child attributes
Show child attributes
Was this page helpful?