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
1 2 3 | 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
1 2 3 4 5 6 7 8 9 | import requestsurl = "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
1 2 3 4 5 6 | import requestsurl = "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
1 2 3 4 5 6 7 8 | 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 = truerequest = Net::HTTP::Get.new(url)response = https.request(request)puts response.read_body& |
Bulk verification
01 02 03 04 05 06 07 08 09 10 | 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 = truerequest = 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
1 2 3 4 5 6 7 8 | 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 = truerequest = Net::HTTP::Get.new(url)response = https.request(request)puts response.read_body< |
PHP
Api One By One
1 2 3 4 5 6 7 | $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
01 02 03 04 05 06 07 08 09 10 11 12 | $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
1 2 3 4 5 6 7 | {"success":true,"message":"","id":"12702","job_id":"1706543459","filename":"example.csv"} |
Get job details:
1 | curl 'https://app.verify550.com/api/getjob/{{JOB_ID}}?secret={{API_SECRET}}' |
Response:
01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | {"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:
1 | curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}&secret={{API_SECRET}}' |
Download results by category:
1 | curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}?categories=ok,email_disabled,unknown&secret={{API_SECRET}}' |
Download results by file format:
1 | 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
01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 | Formats accepted are: xlsx or cCategories 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 |