---
title: "Get a Lead Finder search"
method: GET
path: "/lead-finder/searches/{id}"
tags: ["Lead Finder"]
---

# Get a Lead Finder search

`GET /lead-finder/searches/{id}`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/lead-finder/searches/{id}`
- Auth: HTTP bearer

Returns a search started with POST /lead-finder/searches. While it is still running the request waits up to about six seconds for it to finish before answering, so calling it again right away is fine. A finished search's results can be read for 10 minutes: after that the search reads as status failed with error expired, and after 15 minutes it is not found. Reading a finished page again within those 10 minutes keeps its people's refs valid for another 60 minutes. Searches belonging to other workspaces are reported as not found.

## Path parameters

- `id` string, required

## Response `200`

The search (status running, done or failed)

- ModelsLeadFinderSearch
  - `audienceKey` string: AudienceKey names the filters: the same picks in any order give the same key. Imports from these filters carry it too.
  - `creditsPerProspect` integer
  - `error` string: Error is set on a failed search: rate_limited, provider_blocked, provider_unavailable (the people database is down or in maintenance; try again later), timeout, invalid_filters, budget_exhausted, expired or internal.
  - `hasMore` boolean
  - `maxPage` integer
  - `message` string
  - `page` integer
  - `pageSize` integer
  - `progress` ModelsLeadFinderProgress
    - `added` integer: Added is how many people they added.
    - `adds` integer: Adds is how many imports there were, selected ones included.
    - `lastAddAt` string: LastAddAt is when the latest import from these filters started.
    - `nextFrom` integer: NextFrom is the position in the results (1 is the first person) the next first_n import of these filters starts from.
    - `runningImportId` integer: RunningImportID is a first_n import of these filters still running. Another first_n import of the same filters is refused (409 import_running) until it ends.
  - `results` ModelsLeadFinderPerson[]: Results are the people on this page, masked.
    - `company` ModelsLeadFinderPersonCompany
      - `industry` string
      - `logoUrl` string: LogoURL is the company's icon, an image of at most 64 pixels served by this API with no key needed. The URL does not contain the company's domain. It is left out when the company has no website on record, and answers 404 when the website has no icon.
      - `name` string
      - `revenueBand` string
      - `sizeBand` string
    - `firstName` string
    - `inWorkspace` boolean: InWorkspace is true for someone Lead Finder added to this workspace whose lead is still there, so adding them again is skipped for free. A person who is a lead from another source shows false; adding them is still skipped and costs nothing.
    - `jobFunction` string
    - `lastInitial` string
    - `location` ModelsLeadFinderPersonLocation
      - `city` string
      - `country` string
      - `state` string
    - `ref` string: Ref identifies the person for POST /lead-finder/imports. It stays valid for 60 minutes after the page it came on was last shown.
    - `seniority` string
    - `title` string
  - `rowsLeftToday` integer: RowsLeftToday is the account's browsing allowance left this UTC day.
  - `searchId` string
  - `status` string: Status is running, done or failed.
  - `total` integer: Total is how many people match; TotalIsExact says whether it is a count or a lower bound, and TotalStatus whether the count has landed (pending, done or failed).
  - `totalIsExact` boolean
  - `totalStatus` string

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `403`: plan_required: the workspace's plan does not include Lead Finder
- `404`: not_found: no such search in this workspace, or it has expired
- `409`: provider_unavailable: the contact database is switched off
- `500`: internal

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)