Get search results
get_search_resultsFetch 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"search_id": "<search_id>"
},
"name": "get_search_results"
}
}Input 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
| 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 — and when the period's usage couldn't be read (leads_remaining is null too). | |
| 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. Null when that period's usage couldn't be read just then — ask again. |