Documentation

You can verify emails with our online application or with our real-time API.

Our real-time API is available in PHP, Python, Node.js, and .net.

Follow along below to learn how to use Verify 550 to securely, easily, and efficiently validate and verify your list of email addresses with detailed reports.

Look for a confirmation link and confirm you signed up. Login and you will see the main console.

Developer API

Verify 550 provides a developer API to integrate the email verification process with your service.

Our API provides the ability to check individual email addresses and can accept an email list through file upload.

Our Guarantee

The verification & validation process of Verify 550 always provides 100% accurate results in real-time. For each email address, we present a detailed validation status. We are extremely confident about the level of accuracy we provide, and we are sure that none of your emails will bounce after getting checked with Verify 550.

Although this is a simple approach, there is an overhead involved with SMTP, and email servers often behave unexpectedly. Therefore, many companies rely on Verify 550 to provide email verification. We have been in the email and security industry for the last 10 years and have gained a reputation in the email verification process.

Here are our steps we use for emails validation and verification:

Email deduplication – Domains that match our existing database of invalid emails are removed

Domain validation – DNS entries for every email address are checked and validated

Spam-trap removal – Spam-traps and disposable emails are detected

Spamcop removal – Matches and removes against updated static list of 9 million spamcop traps

Risk validation – Remove all of the domains that match our existing database of invalid emails

Syntax verification – Email address syntax is verified according to IETF standard

MTA validation – Checks if a Mail-Transfer-Agent has a valid MX Record

Protestor removal – Matches against updated static list of 300 million protestors and growing

Litigator removal – Matches against updated static list of 12,000 litigators worldwide

Botclickers removal – Matches against updated domain, email and IP’s of known botclickers

Department role removal – Matches against emails that are shared with groups or departments

Domain blacklist – Matches and removes against known blacklist domains

Disposable removal – Matches and removes against temporary and/or disposable emails

To upload a file, scroll to Verification on your dashboard, click on Import lists and then specify where your file resides. You can also drag and drop your files from your computer to the dotted area in your dashboard.

While you are uploading a file, make sure the following conditions are met for the process process to work smoothly:

• There is only one email address in each row
• Email addresses should appear in the same column
• The list should not have more than 1 million email addresses
• The field names should appear in the first row of the list in order to categorize the list

Below is a screen shot of a file of email addresses to show you how the file should be properly formatted before verification:

Once a list has been processed by Verify 550, a Result column is added in the list to categorize the status of each email. Read more about these statuses at our Result Guide section.

This is how a processed list generally looks:

To access the verified results, proceed to the ‘Verification’ section within your dashboard. From the ‘Imported Lists’ section, select your desired file, then click ‘Download Results.’ A prompt will appear, allowing you to specify the file category (Deliverable/All Results/Custom Results) and format preference (XLSX/CSV).”

Downloading All Results

You can download your entire list by choosing All Results and then clicking on your desired file type.

Downloading Custom Results

If you want to specify the results downloaded, you can choose Custom Results to specify your criteria and then click on your desired file type.

After your file has been validated and verified, each email address in the list will be labeled with one of the following statuses:

Prefix “t“ mean “temporary“, “p_“ mean “permanent“. Prefix very useful because giving additional information about situation:”p_email_disabled” – it means that server say that email is permanently disabled”t_attempt_rejected” it can happens when server just overloaded, and temporary reject verification”p_error” – no information about email existing, but no chance to deliver email in future too”terror” – no information about email existing, but there is some chance that email is alive.

Sub-statuses with prefixes very powerful weapon for email results understanding and choosing email list for mailing.

Learn more about your result codes

• General – contains your user name, contact details and geographical location (country, city, address and zip code)
• Manage users:- allows you to invite new users
• Billing section –  you can enable auto-recharge your account
• Invoice – you can see your invoices generated by the system for your account

APIKey

Email Validation API

Verify 550 provides a developer API to integrate the email verification process with your service.

Our API provides the ability to check individual email addresses and can accept an email list through file upload.

/verifyEmail

Submits an email address for verification.

We provide the following API libraries:

      Python

1. OneByOne Verification:

Code source:

 
import requests url = "https://app.verify550.com/api/singlemail?secret=YOUR_API_KEY&email=exemple@domain.com" 
payload={} headers = {} response = requests.request("GET", url, headers=headers, data=payload) 
print(response.text)

import requests
url = "https://app.verify550.com/api/bulk?secret=YOUR_API_KEY&filename=emailtest2c.csv"
payload={}
files=[
('file_contents',('emailtest2c.csv',open('/Users/mac/Downloads/emailtest2c.csv','rb'),'text/csv'))
]
headers = {}
response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.text)

 Bulk Verification – Download ready file

import requests
url = "https://app.verify550.com/api/details?secret=YOUR_API_KEY&id=File_id"
payload={}
headers = {}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)

  2. Ruby

  Single verification

require "uri"
require "net/http"
url = URI("https://app.verify550.com/api/singlemail?secret=YOUR_API_KEY&email=exemple@domain.com")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body&

Bulk verification

require "uri"
require "net/http"
url = URI("https://app.verify550.com/api/bulk?secret=YOUR_API_KEY&filename=emailtest2c.csv")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
form_data = [['file_contents', File.open('/Users/mac/Downloads/emailtest2c.csv')]]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body

</pre>
<pre>require "uri"
require "net/http"
url = URI("https://app.Everify550.com/api/details?secret=YOUR_API_KEY&id=File_id")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Get.new(url)
response = https.request(request)
puts response.read_body</pre>
<pre>

3. PHP

Api One By One

</pre>
<pre><?php

$curl = curl_init();

curl_setopt_array($curl, array(
CURLOPT_URL => 'https://app.verify550.com/api/singlemail?secret=YOUR_API_KEY&email=exemple@domain.com',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Api – Bulk emails verification

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://app.verify550.com/api/bulk?secret=YOUR_API_KEY&filename=emailtest2c.csv',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => array('file_contents'=> new CURLFILE('/Users/mac/Downloads/emailtest2c.csv')),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Bulk Verification – Download ready file

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://app.Everify550.com/api/details?secret=YOUR_API_KEY&id=File_id',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

The response will be returned in the form of a plain text string:

When the response is fail it can be for one of the following reasons:

PARAMETERS

Query Parameters ?

email

string Required

Email address to test.

200 OK

RESPONSE SCHEMA

String

/verifyApiFile

Submit a list of emails for verification. Upload a file containing your list of emails and it will be returned with an additional field that assigns each email a verification status.

This endpoint expects the file to be in the same format as described in our File Verification section. The updated file will have an additional field attached as described in our Result Guide section.

The response will be returned in the form of a plain text string:

After receiving the upload-id, you can check the processing status and retrieve the finished results using the /getApiFileInfo endpoint.

PARAMETERS

Query Parameters ?

filename

string Required

Filename of uploaded file.

FormData Parameters ?

file_contents

file Required

File contents attached using Content/Type: multipart/form-data.

Responses

200 OK

RESPONSE SCHEMA

String

/getApiFileInfo

Returns the processed file submitted using the /verifyApiFile endpoint or its current processing status.

If the file is still being processed, a response like this will be returned: 10700|my_emails.txt|no|200|150|progress|1445878121||

If the file is ready for downloading, the response will look like this: 10700|my_emails.txt|no|200|200|finished|1445878121|https://apps.verify550.com/app/webroot/files/52/655/result_ok_10700_2015-10-26.csv|https://apps.verify550.com/app/webroot/files/52/655/result_all_10700_2015-10-26.csv

The returned response takes the following form: {file_id}|{filename}|{unique}|{lines}|{lines_processed}|{status}|{timestamp}|{link_ok}|{link_all}

If an error occurred, one of the following responses will be returned:

PARAMETERS

Query Parameters ?

id

string

The upload id as supplied by the /verifyApiFile endpoint.

Responses

200 OK

RESPONSE SCHEMA

String