Email validation snapshot

In response to a new email validation request and whenever you request it directly, Verifalia sends replies with an object representing the snapshot of the current email validation request.

Data structure

Email validation snapshots have the following data structure:

  • uniqueID a unique, random ID assigned by Verifalia to the validation batch
  • engineVersion a string representing the internal Verifalia engine version
  • submittedOn date and time (UTC) the batch has been submitted
  • completedOn date and time (UTC) the batch has been completed, if available
  • progress a literal whose members represent the validation progress
    • noOfTotalEntries the number of total entries being validated
    • noOfCompletedEntries the number of validated entries
  • entries an array with the validation results, if available
    • inputData the original input string passed to Verifalia (for reference purposes)
    • status the validation status for this entry. Can be one of these status codes.
    • completedOn date and time (UTC) the item has been completed
    • emailAddress the email address, without comments and folding white spaces (FWS)
    • asciiEmailAddressDomainPart the ASCII version of the domain part
    • emailAddressLocalPart the local part (or mailbox) of the address
    • emailAddressDomainPart the domain part of the address
    • hasInternationalDomainName if true, the domain name is international
    • hasInternationalMailboxName if true, the mailbox name is international
    • isDisposableEmailAddress if true, the address is disposable
    • isFreeEmailAddress v1.3+ if true, the address is provided by a free email service provider (e.g. Gmail, Yahoo, Outlook / Live / Hotmail, etc.)
    • isRoleAccount if true, the address is a well-known role account
    • syntaxFailureIndex returns the index of the syntax failure within the original input data, if any

    Shorthand status properties for the status property:

    • isSuccess if true, the status indicates a success
    • isSyntaxFailure if true, the status indicates a syntax issue
    • isDnsFailure if true, the status indicates a DNS issue
    • isSmtpFailure if true, the status indicates a SMTP issue
    • isMailboxFailure if true, the status indicates a mailbox issue
    • isCatchAllFailure if true, the status indicates a catch-all issue
    • isTimeoutFailure if true, the status indicates a timeout issue
    • isNetworkFailure if true, the status indicates a network issue

Email validation structure example (JSON)
{
    uniqueID: '1f977ae169024721869cdadbadc3f754',
    engineVersion: '2017-01-23,rev1',
    submittedOn: '2017-01-30T12:06:30',
    completedOn: '2017-01-30T12:06:32',
    entries: [
        {
            inputData: 'john.smith@example.com',
            completedOn: '2014-08-01T12:06:32',
            emailAddress: 'john.smith@example.com',
            asciiEmailAddressDomainPart: 'example.com',
            emailAddressLocalPart: 'john.smith',
            emailAddressDomainPart: 'example.com',
            hasInternationalDomainName: false,
            hasInternationalMailboxName: false,
            isDisposableEmailAddress: false,
            isRoleAccount: false,
            status: 'SmtpConnectionTimeout',
            syntaxFailureIndex: null,
            isCatchAllFailure: false,
            isSuccess: false,
            isTimeoutFailure: true,
            isNetworkFailure: true,
            isSyntaxFailure: false,
            isDnsFailure: false,
            isSmtpFailure: true,
            isMailboxFailure: false
        },
        {
            // More entries...
        }
    ],
    progress: {
        noOfTotalEntries: 97,
        noOfCompletedEntries: 83
    }
}



Not a software developer?

Verifalia is a web-based email validation service which allows to upload and validate lists of email addresses with ease.


You don't need to be a software developer to use Verifalia! Just upload your list of email addresses and we will validate them for you, giving you back a detailed report.


Download the Verifalia SDK

To ease integrating Verifalia with your own software solutions, we are developing helper libraries that you can just download and plug where email validation is required. Validating an email address via Verifalia typically requires a couple of lines of code!

Microsoft .NET SDK

Free and open source helper library, C# language, VS 2010 up to 2015, which allows to integrate Verifalia with other .NET 4.0 and higher solutions.



Node.js SDK

Free and open source helper library which allows to integrate Verifalia with Node.js applications.



PHP SDK

Free and open source helper library which allows to integrate Verifalia with PHP applications.



Ruby SDK

Free and open source helper library which allows to integrate Verifalia with Ruby applications.



Java SDK

Free and open source helper library which allows to integrate Verifalia with Java applications.