List ghost opportunities
Agent-discovered prospects with ICP fit, buying intent, and a warm path.
GET /api/v1/ghost/opportunitiesList your organization's ghost opportunities — prospects the Homie agent discovered, each with an ICP evaluation, buying-intent signals, key insights, and the best warm intro path. Organization-scoped: works with both organization API keys and user MCP tokens, and returns opportunities discovered by anyone in your org.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
status | string | no | One of visible, saved, accepted, intro_requested, dismissed. Default: the active set (visible, saved, accepted, intro_requested). |
sort | string | no | newest (default), oldest, or relevancy (highest overallScore first). |
search | string | no | Substring match on prospect name, company, or position. |
limit | number | no | 1-50, default 20. |
offset | number | no | 0-based offset. Pass the previous response's nextOffset to fetch the next page. |
Example
curl -H "Authorization: Bearer $KEY" \"https://app.usehomie.com/api/v1/ghost/opportunities?sort=relevancy&limit=10"Response
{
"data": {
"opportunities": [
{
"id": "ghost_...",
"prospect": {
"id": "person_...",
"name": "Alex Johnson",
"position": "VP Engineering",
"company": "Stripe",
"linkedinId": "alexjohnson"
},
"overallScore": 87,
"priority": "high",
"confidenceLevel": 82,
"status": "visible",
"introRequested": false,
"discoveredAt": "2026-08-01T09:12:44.000Z",
"searchSource": "icp_search",
"icpEvaluation": { "companyFitScore": 91, "prospectFitScore": 84 },
"buyingIntent": { "overallIntentScore": 73, "urgencyLevel": "high" },
"keyInsights": { "icpFitSummary": "..." },
"bestPath": {
"connectionId": "person_...",
"connectionName": "Maria Silva",
"connectionType": "direct",
"position": "CTO",
"company": "Acme",
"strengthScore": 78,
"userToHomieWarmness": 84
},
"discoveredBy": { "id": "user_...", "name": "Sarah Chen" }
}
],
"totalCount": 143,
"returnedCount": 10,
"limit": 10,
"offset": 0,
"nextOffset": 10,
"hasMore": true
}
}icpEvaluation, buyingIntent, and keyInsights are free-form objects produced by the discovery agent. Prospects working at your own company are excluded. bestPath is the best available intro path whose connector is not one of your own org members — surfacing an internal connector would only echo back what the org already knows; when every path for an opportunity is internal, the opportunity is still returned with bestPath omitted. When hasMore is false, nextOffset is omitted.