---
title: "List ghost opportunities"
method: GET
path: "/api/v1/ghost/opportunities"
tags: ["Ghost"]
---

# List ghost opportunities

`GET /api/v1/ghost/opportunities`

## Request

- Base URL: `https://app.usehomie.com`
- URL: `https://app.usehomie.com/api/v1/ghost/opportunities`
- Auth: HTTP bearer

List the organization's ghost opportunities — agent-discovered prospects with ICP evaluation, buying-intent signals, and a best warm intro path. Org-scoped.

## Query parameters

- `status` 'visible' | 'saved' | 'accepted' | 'intro_requested' | 'dismissed': Default: the active set (visible, saved, accepted, intro_requested)
- `sort` 'newest' | 'oldest' | 'relevancy': Default newest. relevancy = overallScore desc.
- `search` string: Substring match on prospect name, company, or position
- `limit` integer
- `offset` integer, nullable

## Response `200`

Paginated list of ghost opportunities

- object
  - `data` GhostOpportunitiesResult, required
    - `opportunities` object[], required
      - `id` string, required
      - `prospect` object, required
        - `id` string, required
        - `name` string, required
        - `position` string
        - `company` string
        - `linkedinId` string
        - `avatarUrl` string
      - `overallScore` number, required
      - `priority` string, required
      - `confidenceLevel` number, required
      - `status` string, required
      - `introRequested` boolean, required
      - `introStatus` string
      - `discoveredAt` string, required
      - `searchSource` string
      - `icpEvaluation` object
      - `buyingIntent` object
      - `keyInsights` object
      - `bestPath` object
        - `connectionId` string, required
        - `connectionName` string, required
        - `connectionType` string, required
        - `position` string
        - `company` string
        - `avatarUrl` string
        - `strengthScore` number
        - `userToHomieWarmness` number
        - `warmnessBreakdown` object: Free-form map of warmness factor names to values
        - `isAdvocate` boolean
      - `discoveredBy` object
        - `id` string, required
        - `name` string, required
        - `avatarUrl` string
    - `totalCount` number, required
    - `returnedCount` number, required
    - `limit` number, required
    - `offset` number, required
    - `nextOffset` number
    - `hasMore` boolean, required

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Plan required or insufficient scope

---

[API](https://skmtc.dev/usehomie/apis/homie-api.md) - [All operations](https://skmtc.dev/usehomie/apis/homie-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usehomie/apis/homie-api/revisions/00ccf1c3b436?raw)