Email Validation API

Email Validation request

curl --location --request POST 'https://validation.customeros.ai/validateEmail' \
--header 'Content-Type: application/json' \
--header 'X-Openline-API-KEY: YOUR-API-KEY-HERE' \
--header 'X-Openline-USERNAME: YOUR-USERNAME' \
--data-raw '{
    "email": "matt@customeros.ai"
}'

The Email Validation API allows you to make a POST call with any email address and get back a response indicating whether an email address exists or not. The response data should be self-explanitory, here’s an example output:

Email Validation response

{
    "error":null,
    "email":"matt@customeros.ai",
    "acceptsMail":true,
    "canConnectSmtp":true,
    "hasFullInbox":false,
    "isCatchAll":false,
    "isDeliverable":true,
    "isDisabled":false,
    "isReachable":"safe",
    "address":"matt@customeros.ai",
    "domain":"customeros.ai",
    "isValidSyntax":true,
    "username":"matt",
    "normalizedEmail":"matt@customeros.ai"
}

Parameter	Description
`error`	Returns `null` if validation was successful, else it returns the error
`email`	The email address reflected back from the request
`acceptsMail`	Boolean that indicates if mailbox accepts email
`canConnectSmtp`	Boolean that indicates if we were able to connect via SMTP
`hasFullInbox`	Boolean that indicates if mailbox is full
`isCatchAll`	Boolean that indicates if email is a “catch all” address
`isDeliverable`	Boolean that indicates if email address can receive email
`isReachable`	Enum that indicates how confident we are that email address can be trusted. Values are `safe`, `risky`, `invalid`, or `unknown`
`address`	String representing the email address reflected back from the request
`domain`	String representing the domain associated with the email address
`isValidSyntax`	Boolean that indicates whether the email address uses valid syntax
`username`	String representing the username from the email address
`normalizedEmail`	String represeting a normalized email address that removes capitalization, punctutation, etc

When analyzing the response, most people start by looking at the isReachable field. When looking at this field, you’ll notice that email addresses tied to outlook or microsoft exchange servers frequently return as unknown. This does not mean they are bad emails, it just means that microsoft has blocked our ability to interrogate the email address without sending an email.