API
Get a search (poll for enrichment)
Poll a search as verification completes; enriched rows and settled balance.
GET/api/v1/searches/:search_id
Returns the results with enrichment filled in as the worker progresses. Poll until enrichment is "complete" — at that point every lead has been charged and verified, so credits_remaining is final. Enriched rows add the fields below.
| credits_remaining | Your live leads balance — final once enrichment is "complete". |
| delivered | Total leads in the search so far. |
| owner_name | Likely owner/decision-maker when we can identify one — best-effort, only a fraction of leads. |
| emails_data[] | Emails we found (up to 3 per lead), each with an SMTP deliverability status. |
| phones_data[] | Phones we found (up to 3 per lead), each with a line type (mobile/landline/VoIP) + carrier. |
| socials | Facebook, Instagram, LinkedIn, X, YouTube, TikTok, Yelp. |
| enrichment_status | pending | enriched | failed. |
Line type and carrier are checked against telephone numbering and portability data at verification time. How you contact leads is up to you — see our Terms for data-accuracy and outreach-responsibility details (e.g. TCPA rules for calling or texting wireless numbers).