Get search results
get_search_resultsRead-only
Fetch a search's leads with verification filled in as enrichment progresses. Poll until enrichment is 'complete'. Each lead includes verified emails (SMTP status), verified phones (line type + carrier), owner name where identified, socials, and the business profile.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max leads to return (default 25, max 1000). | |
| offset | No | Pagination offset (default 0). | |
| search_id | Yes | The search_id returned by search_leads or enrich_domains. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | ||
| stage | No | queued | discovering | enriching | verifying | complete | failed | cancelled. 'verifying' means every row is delivered and contacts are being verified — often the longest phase, not a stall. | |
| period | No | On a rate-limited plan: { limit, used, resets_at }. Null on a metered plan. | |
| results | Yes | ||
| showing | No | Range shown, e.g. '1–25'. | |
| location | No | ||
| progress | No | { done, total } rows enriched so far. | |
| search_id | Yes | ||
| enrichment | Yes | 'pending' or 'complete'. | |
| next_offset | No | Pass as offset to fetch the next page; null on the last page. | |
| total_leads | Yes | ||
| data_sources | No | Where the sources, licences and notices are for emails and owner names that may come from open datasets and public records. Pass it on with any of this data you share. | |
| queue_position | No | For queued searches, the place in this account's own queue (1 = next). | |
| leads_remaining | No | Leads spendable now. On a plan with no monthly quota this is what is left in the current 7-day period, not a monthly balance. |