conecto. Get started
Prospects

Get a prospect search

prospects_get · Reads only · Markdown

A prospect search by id: its status, progress, its question when it asks one, and the prospects found with their contact details.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

How is the search for kitchen leads going? Show me who you found.

Your agent callsprospects_getFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "search_id": "7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34",
  "limit": 25
}
What comes back
{
  "search_id": "7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34",
  "status": "completed",
  "summary": "40 independent restaurants and hotel kitchens in Hamburg, with a working email for the owner or the head chef.",
  "asked": 40,
  "found": 2,
  "progress": {
    "stage": "completed",
    "title": "Lead list complete",
    "detail": "3 leads are ready."
  },
  "question": null,
  "prospects": [
    {
      "prospect_id": 4101,
      "company": {
        "name": "Restaurant Koch",
        "website": "https://restaurant-koch.example",
        "domain": "restaurant-koch.example",
        "country": "DE"
      },
      "person": {
        "name": "Marie Koch",
        "title": "Owner",
        "location": "Hamburg",
        "linkedin": null
      },
      "email": {
        "address": "marie@restaurant-koch.example",
        "check": "verified"
      },
      "phone": "+49 40 5550 101",
      "saved": false
    },
    {
      "prospect_id": 4102,
      "company": {
        "name": "Restaurant Meyer",
        "website": "https://restaurant-meyer.example",
        "domain": "restaurant-meyer.example",
        "country": "DE"
      },
      "person": {
        "name": "Lukas Meyer",
        "title": "Head chef",
        "location": "Hamburg",
        "linkedin": null
      },
      "email": {
        "address": "lukas@restaurant-meyer.example",
        "check": "accepts_all"
      },
      "phone": "+49 40 5550 102",
      "saved": false
    }
  ],
  "next_offset": null,
  "charged_usd": "$0.10",
  "started_at": "2026-10-14T08:00:00+00:00",
  "ended_at": "2026-10-14T08:00:00Z"
}

Use it when

To follow a search after starting it, and to read the prospects it found.

What it does

A prospect search by id: running, needs_input (it stopped finding new prospects and asks whether to widen it), completed, stopped or failed; its progress, its question when it asks one, and the prospects found so far, named people first: the company, the person and their title, the work email and how it was checked, phone, and whether they are saved to the CRM.

What comes back

search_id, status (running, needs_input, completed, stopped or failed), summary, asked, found (with a working email), progress (stage, title, detail), question (summary and questions, while it waits), prospects (prospect_id; company with name, website, domain and country; person with name, title, location and LinkedIn; email with its address and check: verified, accepts_all or published; phone, saved), next_offset, charged_usd once it ended, started_at, ended_at, and problem when it failed. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
search_idRequiredstringThe call_id prospects_find answered with. Exactly 36 characters.
offsetintegerAt least 0. Default: 0.
limitinteger1 to 100. Default: 25.

The call

Over MCP, call prospects_get on https://api.conecto.chat/mcp/prospects. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/prospects_get \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"search_id":"7c2e4f1a-5b3d-4e8f-9a61-2d0c8b7e5f34","limit":25}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No search on this account has that id.Use a search_id from prospects_list.

More Prospects tools

All 7 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md