LEleadmagic
People Enrichment

Email Finder

Changed on

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

post/v1/people/email-finder

Request

  • Base URL
    https://api.leadmagic.io
  • Auth
    API key in header X-API-Key

Request body

first_namestring

First name of the person (optional if full_name provided). A single initial (J) is accepted when last_name is a full surname.

last_namestring nullable

Last name of the person (optional)

full_namestring nullable

Full name of the person (alternative to first_name + last_name). An initial plus a surname (J Orjuela) is accepted.

domainstring

Company domain name (required if company_name not provided; aliases company_domain, website, url accepted)

company_namestring

Company name (required if domain not provided; aliases company, organization, employer accepted)

profile_urlstring nullable

B2B profile URL or username. Identifies the person and their company on its own, then the email is validated the same way as a name plus domain.

allow_domain_mismatchboolean

By default, an email found on a domain unrelated to the requested one is returned as a free not-found (domain_mismatch: true, credits_consumed: 0). Set to true to return that email instead, flagged domain_mismatch: true and charged like any other valid find.

Example request

{
  "profile_url": "https://www.linkedin.com/in/alex-rivera"
}

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

requested_domainstring

The domain that was searched. Present when the result is on a different domain.

domain_mismatchboolean

True when the only email found is on a domain unrelated to requested_domain. Free not-found by default; returned and charged only with allow_domain_mismatch: true.

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,
  "requested_domain": "leadmagic.io"
}

Changes

  • 1da09b7d884fRevision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 51db6fceee34Revision changes
    • breaking

      added to the response body oneOf list for the response status

    • info

      added the new optional request property

    • info

      removed from the response body allOf list for the response status