Facebook Pixel
APILeads Database

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/enrich

POST 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:

FieldNotes
experienceEmployment history. Sparse — often one current role, frequently absent
departmentsNormalized department labels
companyWebsite companyRevenueCompany detail
locality region continentFiner location

Errors

StatusCause
400Neither email nor linkedinUrl, both together, an unexpected field, or unparseable JSON
404Neither collection matched
500A 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

On this page