---
title: API
description: "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…"
url: "https://verify550.com/documentation/api/"
updated: "2025-10-22"
category: Email Verification
---

# API

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

```python

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

```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)
```

```
 Bulk Verification - Download ready file
```

```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)
```

**Ruby**

Single verification

```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&
```

Bulk verification

```python
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

```python
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&lt
```

PHP
 Api One By One

```php
$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

```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;
```

Bulk Verification - Response

```plain
{
"success":true,
"message":"",
"id":"12702",
"job_id":"1706543459",
"filename":"example.csv"
}
```

Get job details:

```plain
curl 'https://app.verify550.com/api/getjob/{{JOB_ID}}?secret={{API_SECRET}}'
```

Response:

```plain
{
"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:

```plain
curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}&secret={{API_SECRET}}'
```

Download results by category:

```plain
curl 'https://app.verify550.com/api/jobexport/{{JOB_ID}}?categories=ok,email_disabled,unknown&secret={{API_SECRET}}'
```

Download results by file format:

```plain
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

```plain
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
```