---
title: "Get Person Email"
method: POST
path: "/v2/people/enrich/emails"
tags: ["People"]
---

# Get Person Email

`POST /v2/people/enrich/emails`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/people/enrich/emails`
- Auth: HTTP bearer

Find the email address for a person. Use this when you need to contact someone directly and have their LinkedIn URL. Returns `email` (the best address, or null if none was found) plus `emails` — every address we hold for them, best-first. Addresses come from Village, your own synced contacts, or a live Apollo.io lookup whose result is saved to Village. Pass `search_deeper: true` to re-ask Apollo.io when the address you already have looks wrong. People can have their data removed by emailing privacy@village.ai or support@village.ai.

## Request body

- union: Request for person email enrichment
  - object: Person by LinkedIn URL
    - `linkedin_url` string, required: LinkedIn person profile URL
    - `search_deeper` boolean: Skip the private-contact tier and query the provider even when we already hold an address for this person. Costs a credit when it returns one.
  - object: Person by generic URL (auto-detected)
    - `url` string, required: Generic URL (auto-detected)
    - `search_deeper` boolean: Skip the private-contact tier and query the provider even when we already hold an address for this person. Costs a credit when it returns one.

## Response `200`

Email retrieved successfully

- object
  - `data` EnrichEmailsResponse, required: Response for person email enrichment
    - `email` string, nullable, required
    - `emails` string[], required
    - `linkedin_url` string, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Person not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)