# Personal emails lookup

The Person Personal Emails Lookup endpoint retrieves personal email addresses associated with an individual in the Forager dataset. It allows you to input identifying information (such as Linkedin handle or Forager ID) and returns available personal contact emails. By default the endpoint returns only addresses on free webmail / consumer providers (Gmail, Outlook, Yahoo, iCloud, Proton, and similar). Addresses on corporate domains, educational domains (e.g., .edu, .ac.uk), and any other custom domains are excluded — including custom domains a person uses for personal purposes — to keep deliverability of the returned set high. Set the optional `include_all_emails` property to true to also receive those non-consumer addresses. All returned addresses have email_type "personal". If the returned set is empty, the endpoint returns 200 OK with an empty body and does not consume credits.

Endpoint: POST /api/{account_id}/datastorage/person_contacts_lookup/personal_emails/
Version: 1.0.0
Security: Api-Key

## Security:

  - `Api-Key` (unknown)
    apiKey in header X-API-KEY

## Path parameters:

  - `account_id` (integer, required)

## Request fields (application/json):

  - `person_id` (integer)

  - `linkedin_public_identifier` (string)
    LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

  - `include_all_emails` (boolean)
    When false (the default), only consumer-provider addresses (Gmail, Outlook, Yahoo, iCloud, Proton, and similar) are returned. When true, every strict email on record is returned, including corporate, educational and other custom domains. All returned addresses have email_type "personal".

## Response 200 fields (application/json):

  - `email` (string, required)

  - `email_type` (string, required)

  - `validation_status` (string, required)
    * `valid`
 - Valid
* `risky`
 - Risky
* `invalid`
 - Invalid
* `unknown`
 - Unknown
    Enum: "valid", "risky", "invalid", "unknown"

