Email

👍 Required plan

Available only in the BUSINESS plan.

Component	Type	Description
@type	String	Either one of 'personal’ or 'work’. Default is 'personal’.
address	String	Valid email address in simple form. No brackets of any kind.
address_md5	String	MD5 hash of the address.
@disposable	Boolean	Whether this is a disposable email (for example guerillamail.com). Response only. Omitted if false.
@email_provider	Boolean	Whether this email came from a public provider (such as gmail.com). Response only.

Search Requirements

For an email object to be sufficient for a search, it must contain a valid email address or an MD5 hash of a valid email address.

MD5 Calculation Guidelines

When sending an MD5 hash of an email address, we recommend normalizing the email before calculating the hash:

• The entire email should be in lowercase.
• If the username contains a plus (+) character, remove it and any trailing character (so clark.kent+something@example.com will become clark.kent@example.com).
• For Gmail addresses only:

  • If the email domain ends with "googlemail.com", replace this with "gmail.com".
  • Remove any dots in the username.

Example

{
  "@valid_since": "2010-08-17",
  "@last_seen": "2020-10-06",
  "@type": "work",
  "@email_provider": false,
  "address": "clark.kent@thedailyplanet.com",
  "address_md5": "eb3e11de3c9cefc2d9d70972350e2b28"
},

{
	"@disposable": true,
	"@email_provider": false,
	"address": "ck242@guerrillamail.com",
	"address_md5": "999e509752141a0ee42ff455529c10fc"
},
{
	"@type": "personal",
	"@email_provider": true,
	"address": "clark@gmail.com",
	"address_md5": "501548362894b9a08f071b1565d8aa14"
}