# Prospect

URL: /business/nouns/prospect · Id: `noun:prospect`

> A Prospect is a person or Organization a Startup found but who has never engaged, held with the legal basis for contact.

A Prospect is a person or [Organization](/business/nouns/organization) a [Startup](/business/nouns/startup) found but who has never engaged, held with the legal basis for contact. Its first reply [engages](/business/nouns/prospect/engage) it, which makes it a [Lead](/business/nouns/lead).

## Properties
| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `foundIn` | `string` | Yes | Where the Startup found them. |
| `basis` | `string` | Yes | The legal basis for contacting them. |

## Object
```json
{
  "$id": "https://api.sb/petpantry.shop/prospects/prospect_1",
  "$type": "Prospect",
  "foundIn": "Example found in",
  "basis": "Example basis"
}
```

## Relationships
- <a id="rel-acquired-by"></a>A Prospect **is acquired by** one [Acquisition](/business/nouns/acquisition): a Prospect’s [Acquisition](/business/nouns/acquisition) names the outbound [Play](/business/nouns/play) and [Mailbox](/business/nouns/mailbox) that first reached it. `acquiredBy`, inverse [`prospects`](/business/nouns/acquisition#rel-prospects).
- <a id="rel-converts-to"></a>A Prospect **converts to** one [Lead](/business/nouns/lead): a Prospect becomes a [Lead](/business/nouns/lead) on first engaging, such as a reply or a [Form](/business/nouns/form) submission. `convertsTo`, inverse [`convertedFrom`](/business/nouns/lead#rel-converted-from).

## Verbs
| Verb | Description | Subject | Event | Class |
| --- | --- | --- | --- | --- |
| [Prospect.engage](/business/nouns/prospect/engage) | Engage records a Prospect’s first reply or raised hand and makes it a Lead that keeps its Acquisition. | [Prospector](/agents/sales/prospector) | [`Prospect.engaged`](/business/events/Prospect.engaged) | Two-way: `try`, `send`, `do` |
| <a id="create"></a>[Prospect.create](/business/nouns/prospect/create) | Creates a Prospect. Inherited from [Noun](/business/nouns/noun). | None. | `Prospect.created` | Two-way: `try`, `send`, `do` |
| <a id="get"></a>[Prospect.get](/business/nouns/prospect/get) | Returns one Prospect by id. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="list"></a>[Prospect.list](/business/nouns/prospect/list) | Returns Prospects, newest first, one page at a time. Inherited from [Noun](/business/nouns/noun). | None. | None. | Read: `try`, `do` |
| <a id="update"></a>[Prospect.update](/business/nouns/prospect/update) | Changes the given properties of a Prospect. Inherited from [Noun](/business/nouns/noun). | None. | `Prospect.updated` | Two-way: `try`, `send`, `do` |
| <a id="delete"></a>[Prospect.delete](/business/nouns/prospect/delete) | Deletes a Prospect; its history is kept. Inherited from [Noun](/business/nouns/noun). | None. | `Prospect.deleted` | One-way: `send`, `do` |

## Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.

| Operation | `owner` | `admin` | `member` | `viewer` |
| --- | --- | --- | --- | --- |
| `Prospect.create` | Yes | Yes | Yes | No |
| `Prospect.get` | Yes | Yes | Yes | Yes |
| `Prospect.list` | Yes | Yes | Yes | Yes |
| `Prospect.update` | Yes | Yes | Yes | No |
| `Prospect.delete` | Yes | Yes | Yes | No |
| `Prospect.engage` | Yes | Yes | Yes | No |

## Call it

**Ask**

```text
Engage the prospect Priya Natarajan.
```

**API**

```bash
curl -X POST https://api.sb/ledgerlark.com/prospects/prospect_1/engage \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
```

```json
{
  "api": "https://api.sb/ledgerlark.com",
  "lead": {
    "$id": "https://api.sb/ledgerlark.com/leads/lead_1",
    "$type": "Lead",
    "status": "new"
  },
  "prospect": {
    "$id": "https://api.sb/ledgerlark.com/prospects/prospect_1",
    "$type": "Prospect",
    "foundIn": "Example found in",
    "basis": "Example basis"
  },
  "action": {
    "$id": "https://api.sb/ledgerlark.com/actions/action_1",
    "operation": "Prospect.engage",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/ledgerlark.com/actions/action_1"
  }
}
```

**SDK**

```ts
import { $ } from 'startup-builder'

const { lead, prospect } = await $.Prospect.engage({ prospect: 'prospect_1' })
```

**CLI**

```bash
npx startup-builder do Prospect.engage --json '{"prospect":"prospect_1"}'
```

**MCP**

```json
{
  "name": "do",
  "arguments": {
    "code": "return await $.Prospect.engage({ prospect: 'prospect_1' })"
  }
}
```

## Example
A litigation-support firm found on a public list of court vendors becomes a Prospect, held with legitimate interest as the basis for one outreach email.