Skip to content
Docs

Get Saved Search

Read one saved search.

GET/api/v1/lead-finder/saved-searches/{saved_search_id}

Requires an API key with the read scope.

Path Parameters#

saved_search_idstringpathrequired
The saved search id.

Response#

dataobject
Show data
idstring
Saved search identifier.
namestring
Name.
kindstring
people or companies.
filtersobject
The stored filter object.
lastRunAtstring
ISO 8601 timestamp of the last run, or null.
lastTotalinteger
Result count from the last run, or null.
alertEnabledboolean
Whether alerts are on for this search.
createdAtstring
ISO 8601 timestamp.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Lead Finder is not enabled while Lead Finder is switched off on this environment
503Lead Finder is not configured when it is enabled but has no data provider key
404Saved search not found: it does not exist in this workspace

Rate Limit#

  • 300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026