Our API makes use of api key based authentication. You can generate your API key by visiting the API section of your dashboard.
APIKey
Security scheme type: API Key
query parameter name:secret
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 several API libraries like Python, Ruby, C#, PHP.
Python
OneByOne Verification:
Code source:
GET Single Verification
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)
Bulk Verification – Upload file
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)
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
Bulk Verification – Download ready file
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<
PHP
Api One By One
$curl = curl_init('https://".env('HOSTNAME')."/api/verifyemail?secret={{API_SECRET}}&email={{EMAIL_ADDRESS}}');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Api – Bulk emails verification
$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;
Bulk Verification – Response
{
"success":true,
"message":"",
"id":"12702",
"job_id":"1706543459",
"filename":"example.csv"
}
Get job details:
curl 'https://app.verify550.com/api/getjob/{{JOB_ID}}?secret={{API_SECRET}}'
Response:
{
"success": true,
"message": null,
"data": {
"jobId": "1706543459",
"status": "finished",
"file_name": "example.csv",
"count": 1221,
"duplicates": 0,
"processed": 1221,
"uploadTime": "2024-01-29T13:09:35.008Z",
"startTime": "2024-01-29T13:09:36.619Z",
"completionTime": "2024-01-29T13:10:26.247Z",
"suppression_results": {
"ok": 750,
"email_disabled": 118,
"disposables": 1,
"unknown": 1,
"ok_for_all": 116,
"antispam_system": 8,
"spamtraps": 0,
"spamcops": 1,
"litigators": 0,
"complainers": 10,
"hard_bounces": 17,
"soft_bounce": 0,
"dead_server": 0,
"invalid_mx": 53,
"invalid_syntax": 2,
"smtp_protocol": 4,
"sleeper_cell": 0,
"seeds": 0,
"email_bot": 25,
"bot_clickers": 0,
"blacklisted": 62,
"departmental": 43,
"lashback": 0,
"thread_endings": 0,
"thread_string": 0,
"advisory_trap": 0,
"invalid_vendor_response": 3
}
}
}
Download all results:
curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}&secret={{API_SECRET}}'
Download results by category:
curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}?categories=ok,email_disabled,unknown&secret={{API_SECRET}}'
Download results by file format:
curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}?format=xlsx&secret={{API_SECRET}}'
Response will be a .zip file with the results files in the format required and categories selected
Formats accepted are: xlsx or c
Categories accepted are:
- ok
- ok_for_all
- dead_server
- invalid_mx
- email_disabled
- invalid_syntax
- smtp_protocol
- unknown
- antispam_system
- soft_bounce
- complainers
- sleeper_cell
- seeds
- invalid_vendor_response
- hard_bounces
- email_bot
- spamcops
- spamtraps
- threat_endings
- threat_string
- advisory_trap
- blacklisted
- disposables
- bot_clickers
- litigators
- departmental
