Documentation

Verify550 is the ultimate tool for validation and verification all in one easy step. Validation (eHygienics technology) removes threats like bots, traps, protestors, litigators, syntax and checks the mx records for inconsistencies, while verification performs smtp handshakes recording the result giving you accurate information on soft or hard bounces.

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.

To begin using Verify 550 you will first need to create a free account. You can sign up by visiting the link here: https://app.verify550.com/users/signup

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

Utilize the drag-and-drop functionality to seamlessly transfer your list from your local drive directly into the designated area indicated by the dotted outline. Alternatively, opt for the ‘Import lists’ option and proceed through the straightforward steps to upload your list. Upon successful upload, designate your file by selecting it, then initiate the processing by clicking ‘Start List.’ Allow a brief moment for the system to process the data, after which you’ll be able to download a thoroughly verified list. Keep in mind, the processing duration scales with the size of the list, necessitating patience for larger datasets.

Our API can be integrated into your web applications to verify email addresses in real time. Using the API requires only a few lines of code. For more details, please visit our Developer API section below.

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.

Verify 550 uses a prominent mail transfer protocol called SMTP (Simple Mail Transfer Protocol) to check if the user’s email address is invalid or non-working without sending actual emails to that recipient address.

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

Verify 550 provides multiple avenues for importing your email address list for verification purposes. You have the option to upload CSV, XLS, and TXT files directly from your local computer drive or from cloud storage platforms like Google Drive. Additionally, you can fetch the list from a web server for seamless integration

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:

After the verification process, retrieve the results effortlessly in CSV or XLSX formats through a variety of options: opt for a single suppression category, amalgamate multiple suppression categories, isolate deliverables exclusively, or compile all outcomes into a unified file.

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.

Verify 550’s validation first scans to identify disposable, spam-trap, complaint (protestors), botclicker, litigator, spamcop and domain blacklist emails and then runs the email identification process for verification.

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

You will have the following five tabs under Account Settings which you can use to manage your account:

• 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

Our API makes use of api key based authentication. You can retrieve your API key by visiting the API section of your dashboard.

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:

[sourcecode language=”python”]
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)
[/sourcecode]

 Bulk Verification – Download ready file

[sourcecode language=”python”]
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)
[/sourcecode]

  2. Ruby

  Single verification

[sourcecode language=”python”]
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&
[/sourcecode]

Api One By One

Api – Bulk emails verification

[php]

$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://".env('HOSTNAME')."/api/bulk?secret={{API_SECRET}}&filename=example.csv',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => array('file_contents'=> new CURLFILE('path/to/your/file.csv')),
));

$response = curl_exec($curl);
curl_close($curl);

echo $response;
[/php]

Bulk Verification – 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

Verify550 is the ultimate tool for phone validation. Unlike generic phone validators that rely on outdated databases — with our proprietary “Carrier-Direct Line Intelligence”  Verify550 taps directly into carrier networks in real-time to confirm number activity and line status ensuring true validation, not just a surface-level check.

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.

Discover how to use Verify 550 to securely, easily, and efficiently validate your list of phone numbers with detailed reports. Let’s get started. 

To begin using Verify 550 services you will first need to create a free account. You can sign up by visiting the link here: https://app.verify550.com/signup

Verify550 provides multiple avenues for importing your phone list for validation. You have the option to upload CSV and TXT files directly from your local computer drive or from cloud storage platforms like Google Drive.

You can use the drag-and-drop feature to transfer your list from your local drive directly into the designated area indicated by the dotted outline.

Alternatively, you can use the ‘Import lists’ option and follow the straightforward steps to upload your list.

You can also fetch the list from a web server for seamless integration.

While uploading a file, make sure the following conditions are met for the process process to work smoothly:There is only one phone number in each row
Phone numbers should appear in the same column
The field names should appear in the first row of the list in order to categorize the list
There is a 25MB file size limit for phone validations.

Our API can be integrated into your web applications to validate phone numbers in real time. Using the API requires only a few lines of code.

Developer APIVerify550 provides a developer API to integrate the phone validation process with your service.

Our API provides the ability to check individual phone numbers and can accept a list of phone numbers phone through file upload.

Bulk Phone List Upload (/bulkPhoneList)

Submits a list of phone numbers contained within a file for bulk validation.

• Method:POST`
• Endpoint:https://app.verify550.com/api/bulkPhoneList`
• Authentication: Uses API Key passed as a query parameter.`

Parameters:
Query Parameters:
secret(string, Required): Your Verify550 API Key.
filename(string, Required): The name you want the uploaded file to have (e.g.,my_phones.csv ,list_to_validate.txt ).
Form Data ( multipart/form-data ):
file_contents(file, Required): The actual file containing the phone numbers list (one perline, ensure correct column formatting if applicable as per section 14).

Example Request ( cURL):

[sourcecode language=”python”]

curl –request POST \
–url 'https://app.verify550.com/api/bulkPhoneList?
secret=YOUR_API_KEY&filename=phone_list_upload.csv' \
–header 'content-type: multipart/form-data' \
–form 'file_contents=@/path/to/your/local/phone_list.csv'

[/sourcecode]

We can provide other example requests:

Python

[sourcecode language=”python”]
import http.client
conn = http.client.HTTPSConnection("app.verify550.com")
payload = "—–011000010111000001101001\r\nContent-Disposition: form-data; name=\"file_contents\"; filename=\"phone_list.csv\"\r\nContent-Type: text/csv\r\n\r\n\r\n—–011000010111000001101001–\r\n"
headers = { 'content-type': "multipart/form-data; boundary=—011000010111000001101001" }
conn.request("POST", "/api/bulkPhoneList?%20secret=YOUR_API_KEY&filename=phone_list_upload.csv", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
[/sourcecode]

Ruby

[sourcecode language=”python”]
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://app.verify550.com/api/bulkPhoneList?%20secret=YOUR_API_KEY&filename=phone_list_upload.csv")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'multipart/form-data; boundary=—011000010111000001101001'
request.body = "—–011000010111000001101001\r\nContent-Disposition: form-data; name=\"file_contents\"; filename=\"phone_list.csv\"\r\nContent-Type: text/csv\r\n\r\n\r\n—–011000010111000001101001–\r\n"

response = http.request(request)
puts response.read_body
[/sourcecode]

PHP

[php]
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://app.verify550.com/api/bulkPhoneList?%20secret=YOUR_API_KEY&filename=phone_list_upload.csv",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "\r\nContent-Disposition: form-data; name=\"file_contents\"; filename=\"phone_list.csv\"\r\nContent-Type: text/csv\–\r\n",
CURLOPT_HTTPHEADER => [
"content-type: multipart/form-data;"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}

[/php]

Example Success Response:
Upon successful submission, the API will likely return a JSON response similar to the email bulk
upload, containing an identifier for the submitted job:

[sourcecode language=”python”]
{ "success": true,
"message": "File uploaded successfully for phone validation.",
"id": "unique_job_id",
"filename": "phone_list_upload.csv" }
[/sourcecode]

Our Guarantee

The validation process Verify550 provides 99% accurate results in real-time. With our proprietary “Carrier-Direct Line Intelligence”  we provide detailed validation status.

With 20 years of marketing experience under our belts, we were not satisfied with off the shelf phone validation solutions, so we built our own. Our proprietary “Carrier-Direct Line Intelligence” uses a multi multi-pronged approach that connects directly to carriers using CNAM, LRN and other protocols.

This multi pronged approach gives us the most accurate results in the industry.

After the validation process, you can download the results in CSV or XLSX formats through a variety of options:

You can download “all results”, or opt to download only the “valid” or “invalid” phone numbers.

As part of our service we identify whether the line is a mobile line and append the person’s name to the file if available.

A prompt will appear, allowing you to specify the file category (all results, valid, or invalid) and format preference (XLSX/CSV). You can then download the zipped file.

Once a list has been processed by Verify550, a “result” column is added as the first column of the list to indicate whether the phone number is valid or not.

A result of “ok” means the line is active, while “inactive” means the line is not in use.

We also append the following information to your file if available:

Result_line_type

Result_carrier

Result_location

Result_country_name

Result_country_timezone

Result_country_code

Result_country_utcoffset

Result_country_dstobservedhrs

Result_international_format

Result_local_format

Result_e164_format

Result_can_be_internationally_dialled

Result_validated_at

Result_cnam_name.