fetch_leads

ai.onsa/onsa · Verify this server

Returns the status and any results of a find_leads job, by jobId. Status values: "pending" - the search is still running, though `leads` may already hold a partial list; "completed" - the agent delivered a batch, which is not a guarantee that no more will arrive, and `total` may still rise; "stalled" - no leads arrived for about 15 minutes, meaning the agent asked a question, errored, or never delivered. Also returns `total` (leads in this response), `campaignId` (accepted by get_campaign, get_campaign_leads and get_campaign_stats) and `campaignUrl`, a deep link to the prospects tab for this search in Onsa. `agentMessage` is agent text from this campaign's chat, filtered to what was said after this job started, so it never predates the request - though on a campaign with several searches it can be a late message from an earlier one. A null `agentMessage` does not mean the agent is silent: artifact-only messages carry no text, and an agent that errored writes nothing there at all. The agent cannot be replied to through this API. Each lead carries name, companyName, linkedInUrl, position, headline, location, industry, companyUrl, email (often null), and score (1-5) with scoreExplanation, the reasoning for why this person matches the ICP.