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
  • priority v1.4+ the batch priority, relative to the other batches running within the same Verifalia subscription. It comes as a numeric value, between 0 and 255, where the default (127, normal priority) is omitted for brevity from the snapshot.
  • progress a literal whose members represent the validation progress
    • noOfTotalEntries the number of total entries being validated
    • noOfCompletedEntries the number of validated entries
    • estimatedRemainingTime v1.4+ the total estimated time required to finish validating the job, if available, expressed in the format dd.hh:mm:ss (where dd: days, hh: hours, mm: minutes, ss: seconds), where the initial dd. part is added only for huge lists requiring more than 24 hours to complete.
  • 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
    • duplicateOf v1.4+ available only for entries with a status equals to Duplicate, returns the zero-based index of the first occurrence of the email address the entry appears to be duplicated with

    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-06-29,rev1',
    submittedOn: '2017-06-30T09:07:13',
    entries: [
        {
            inputData: 'john.smith@example.com',
            completedOn: '2017-06-30T09:07:14',
            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,
        estimatedRemainingTime: '00:00:12'
    }
}



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 2015 solution, which allows to integrate Verifalia with other .NET 4.5 and higher solutions. Nuget package available!



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.