List Saved Searches

The workspace's saved Lead Finder searches.

GEThttps://api.foxreach.io/api/v1/lead-finder/saved-searches

Requires an API key with the read scope.

Each saved search carries its filters. Pass filters as the body of Search People or Count People (or the company equivalents when kind is companies) to run it again.

Response#

dataobject

Result.

Show data

savedSearchesarray

Saved searches.

Show savedSearches

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#

Status	Description
`401`	Missing, invalid, revoked or expired API key
`403`	API key does not have the required scope: `read`
`404`	`Lead Finder is not enabled` while Lead Finder is switched off on this environment
`503`	`Lead Finder is not configured` when it is enabled but has no data provider key

Rate Limit#

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Request

curl -X GET "https://api.foxreach.io/api/v1/lead-finder/saved-searches" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
searches = client.lead_finder.list_saved_searches()

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const searches = await client.leadFinder.savedSearches();

Response

{
  "data": {
    "savedSearches": [
      {
        "id": "ss_abc123",
        "name": "Austin CTOs",
        "kind": "people",
        "filters": { "jobTitles": ["CTO"], "locations": ["Austin"] },
        "lastRunAt": "2026-10-28T16:30:00",
        "lastTotal": 312,
        "alertEnabled": false,
        "createdAt": "2026-10-20T09:00:00"
      }
    ]
  }
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026