Enrich a Person
Resolve one email address or LinkedIn URL against the leads database and return the full profile and investor record. Makes no external call and consumes no credits.
POST /leads/enrich
Resolve one identifier against both collections.
No external API call, no provider, no credits. This is a lookup in the stored dataset.
Request
Exactly one of email or linkedinUrl.
curl -u "$LEADS_USER:$LEADS_PASS" -X POST \
-H "Content-Type: application/json" \
-d '{"linkedinUrl":"https://www.linkedin.com/in/gary-althoff"}' \
https://api.connectsafely.ai/leads/enrichPOST rather than GET so email addresses stay out of access logs. The cost is that responses are not cacheable by intermediaries.
Response
{
"profile": {
"fullName": "Gary Althoff",
"jobTitle": "VP Engineering and Product Development",
"departments": ["engineering", "engineering product development"],
"emails": ["gary.althoff@kineticupstream.com"],
"emailStatus": "Verified",
"phoneNumbers": ["+1 713-438-5435"],
"companyName": "Kinetic Upstream Technologies",
"companyWebsite": "https://kineticupstream.com",
"companyRevenue": "$1M to <$10M",
"locality": "houston",
"region": "texas",
"continent": "North America",
"experience": [
{
"company": "Kinetic Upstream Technologies",
"title": "VP Engineering and Product Development",
"url": "https://www.linkedin.com/company/kinetictechnologies",
"companyDomain": "kineticupstream.com",
"startDate": "2017-01-01",
"isCurrent": true,
"location": "houston, tx, united states"
}
]
},
"investor": {
"kind": "person",
"title": "Partner",
"facets": { "stages": ["Pre-Seed"] }
},
"matchedOn": "email"
}Both halves are optional and at least one is present on a 200. A 404 means neither collection matched.
Why both halves
An angel investor legitimately has a profile record (job, company, contact details) and an investor record (cheque size, stages, sectors). Returning both avoids making you guess which to call, then discovering it was both. A /company/ URL returns the investor half alone, since firms have no profile record.
There is deliberately no separate investor lookup endpoint.
Fields not in search results
/leads/enrich returns the full record, including fields the search projection omits:
| Field | Notes |
|---|---|
experience | Employment history. Sparse — often one current role, frequently absent |
departments | Normalized department labels |
companyWebsite companyRevenue | Company detail |
locality region continent | Finer location |
Errors
| Status | Cause |
|---|---|
| 400 | Neither email nor linkedinUrl, both together, an unexpected field, or unparseable JSON |
| 404 | Neither collection matched |
| 500 | A collection was unreachable. Never a partial 200 — a half-answered result that looks complete is worse than an error, because you cannot tell an absent record from an unreachable one |
Vendors and Technologies
List the technologies detected across 22 million companies, find the companies running one, and filter people by their employer's stack.
Search Investors
Faceted search over VC firms, private equity, family offices and angels by stage, sector, type and geography, with live filter-aware counts and full-text search.
