v3

latestOpenAPI 3.1.02026-07-318648277.6 KB

People Enrichment

Email Finder

Find a person's work email address using their name and company information.

post/v1/people/email-finder

Request body

first_namestring

First name of the person (optional if full_name provided)

last_namestring nullable

Last name of the person (optional)

full_namestring nullable

Full name of the person (alternative to first_name + last_name)

domainstring

Company domain name (required if company_name not provided)

company_namestring

Company name (required if domain not provided)

Response

Successful response with email details

emailstring

statusstring

credits_consumedinteger

messagestring

first_namestring

last_namestring

domainstring

mx_recordstring

mx_providerstring

mx_security_gatewayboolean

has_mxboolean

Whether the domain has MX records

company_namestring

company_industrystring

company_sizestring

company_foundedinteger

company_profile_urlstring

company_profile_idstring

company_facebook_urlstring

company_twitter_urlstring

company_typestring

employment_verifiedboolean nullable

Whether the employment at the domain was verified

Example response

{
  "email": "alex.rivera@example.com",
  "status": "valid",
  "credits_consumed": 1,
  "message": "Valid email found.",
  "first_name": "Alex",
  "last_name": "Rivera",
  "domain": "leadmagic.io",
  "mx_record": "alt3.mx1.example.com",
  "mx_provider": "Example Mail",
  "has_mx": true,
  "mx_records_full": [
    {
      "priority": 10,
      "exchange": "mx1.example.com"
    }
  ],
  "company_name": "Leadmagic",
  "company_size": "11-50",
  "company_founded": 2022,
  "company_location": {
    "name": "boston, massachusetts, united states",
    "locality": "boston",
    "region": "massachusetts",
    "metro": "boston, massachusetts",
    "country": "united states",
    "continent": "north america",
    "street_address": "1 seaport lane",
    "postal_code": "02210",
    "geo": "42.35,-71.06"
  },
  "company_profile_url": "leadmagichq",
  "company_profile_id": "75153174",
  "company_type": "private",
  "employment_verified": true
}