People

Reverse Lookup by Email

Reverse email lookup: find out who an email address belongs to. If Village does not already know the address, it is sent to Apollo.io to identify its owner, and the match is saved to Village; a profile Village does not have yet is then fetched from HarvestAPI and saved too. Use this when a signup, inbound reply, or CRM row gives you only an email and you need the person behind it. Returns the same profile data as enrich_person — full name, headline, current title and company, location, profile photo URL, and LinkedIn URL. People can have their data removed by emailing privacy@village.ai or support@village.ai.

post/v2/people/enrich/by-email

Request

  • Base URL: https://api.village.ai
  • URL: https://api.village.ai/v2/people/enrich/by-email
  • Auth: HTTP bearer

Request body

emailstring email required

Work or personal email address of the person to look up

mode'cached_first' | 'cached_only' | 'realtime_only'

How to source the data. cached_first (default): return Village's cached profile if it is recent, otherwise fetch live — credited only when it fetches. cached_only: never fetch live, and report a miss when the profile is not already cached (404 on the single endpoints, a per-item not-found on the bulk ones) — never credited. realtime_only: always fetch live, and credited whenever that fetch returns data; a fetch that finds nothing is still free.

Example request

{
  "email": "satya@microsoft.com",
  "mode": "cached_first"
}

Response

Person found for this email

Example response

{
  "data": {
    "work_relevant": {
      "company": {
        "id": 11111,
        "name": "Acme Corporation",
        "linkedin_url": "https://linkedin.com/company/acme",
        "domain": "acme.com",
        "website": "https://acme.com",
        "industry": "Technology",
        "employee_count": 5000,
        "image_url": "https://logo.clearbit.com/acme.com",
        "headquarters": "San Francisco, California, United States",
        "type": "Public",
        "founded_year": 2015
      }
    },
    "work_history": [
      {
        "company": {
          "id": 11111,
          "name": "Acme Corporation",
          "linkedin_url": "https://linkedin.com/company/acme",
          "domain": "acme.com",
          "website": "https://acme.com",
          "industry": "Technology",
          "employee_count": 5000,
          "image_url": "https://logo.clearbit.com/acme.com",
          "headquarters": "San Francisco, California, United States",
          "type": "Public",
          "founded_year": 2015
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.