Back to API overview
Prospects
RoadmapOutbound 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/prospectsreadRoadmapList 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/qualifywriteRoadmapQualify 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"
}