Expert AI Labs
Back to API overview

Prospects

Roadmap

Outbound prospect records produced by the AI qualification pipeline (separate from inbound `leads`). Includes enrichment data, qualification verdict, and outreach state. Activates during pilot phase.

GET/api/v1/prospectsreadRoadmap

List prospects

Cursor-paginated. Filter by qualification_status, vertical, outreach_status.

Example response
{
  "data": [
    {
      "id": "1c4f7d28-3a90-4e2c-9b3a-8d5f1e0c7a32",
      "company_name": "Sandy Springs Property Group",
      "contact_name": "Daniel Park",
      "contact_email": "dpark@example.com",
      "vertical": "property_management",
      "qualification_status": "qualified",
      "outreach_status": "sequence_active",
      "created_at": "2026-04-21T11:08:43.000Z"
    }
  ],
  "next_cursor": null
}
POST/api/v1/prospects/qualifywriteRoadmap

Qualify a prospect

Triggers the AI qualification agent. Returns qualification verdict with structured rationale.

Example request body
{
  "prospect_id": "1c4f7d28-3a90-4e2c-9b3a-8d5f1e0c7a32"
}
Example response
{
  "prospect_id": "1c4f7d28-3a90-4e2c-9b3a-8d5f1e0c7a32",
  "qualified": true,
  "fit_score": 82,
  "rationale": [
    "Manages 28 multifamily buildings inside service radius",
    "No incumbent restoration vendor on record (last 24 months)",
    "Recent water-loss incident reported in news 2026-03"
  ],
  "qualified_at": "2026-04-27T19:08:01.901Z"
}