DecisionMaker.EmailEndpoints
find-email
Start an AI-powered search for an executive email at a domain.
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
{ "url": "acme.com", "role": "CEO", "forceRefresh": false }Response
{ "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
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.