# find-email (/docs/api/endpoints/find-email)



`POST /api/v1/find-email`

Start an AI-powered search for an executive email at a domain. Returns a `searchId` you poll until the search completes.

**Request**

```json
{ "url": "acme.com", "role": "CEO", "forceRefresh": false }
```

**Response**

```json
{ "searchId": "k1709..." }
```

`forceRefresh` skips the team's cache and always runs a fresh search (still costs 1 credit).

Credit cost: 1 credit per fresh search. Refunded on failure or zero results. Cached searches are free.

Supported roles [#supported-roles]

`role` is case-sensitive and must be exactly one of:

| Value               | Title                     |
| ------------------- | ------------------------- |
| `CEO`               | Chief Executive Officer   |
| `CTO`               | Chief Technology Officer  |
| `COO`               | Chief Operating Officer   |
| `CFO`               | Chief Financial Officer   |
| `CMO`               | Chief Marketing Officer   |
| `CIO`               | Chief Information Officer |
| `CPO`               | Chief Product Officer     |
| `CoS`               | Chief of Staff            |
| `Founder`           | Founder                   |
| `Co-Founder`        | Co-Founder                |
| `President`         | President                 |
| `Managing Director` | Managing Director         |
| `VP of Sales`       | VP of Sales               |
| `VP of Engineering` | VP of Engineering         |
| `VP of Marketing`   | VP of Marketing           |
| `SVP`               | Senior Vice President     |
| `EVP`               | Executive Vice President  |

Submitting any other value returns `400` with a JSON error listing the valid roles.