Personal emails lookup

Request

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. 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. If the filtered set is empty, the endpoint returns 200 OK with an empty body and does not consume credits.

Security

Api-Key

Path

account_idintegerrequired

Body

person_idinteger

linkedin_public_identifierstring

LinkedIn organization "Public identifier/Slug/ID" - "linkedin.com/in/!slug!/".

curl -i -X POST \
  'https://api-v2.forager.ai/api/{account_id}/datastorage/person_contacts_lookup/personal_emails/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "person_id": 0,
    "linkedin_public_identifier": "string"
  }'

Responses

Bodyapplication/json

Array [

emailstring, (email)read-onlyrequired

email_typestringread-onlyrequired

validation_statusstring(ValidationStatusEnum)read-onlyrequired

valid - Valid
risky - Risky
invalid - Invalid
unknown - Unknown

Enum:"valid""risky""invalid""unknown"

]

Response

[
  {
    "email": "user@example.com",
    "email_type": "string",
    "validation_status": "valid"
  }
]