REST API Documentation
API Documentation
Integrate email verification into your application in minutes. Simple REST API with comprehensive examples.
<1s Response
Average latency
99.9% Uptime
SLA guarantee
REST API
Any language
10 req/sec
Rate limit
Quick Start
1
2
Make your first request
Use the API endpoint with your key to verify any email address.
# Single email verification
curl -X GET "https://api.mailveri.com/v1/verify?email=test@example.com" \
-H "Authorization: Bearer YOUR_API_KEY"
# Response
{
"email": "test@example.com",
"status": "VALID",
"is_disposable": false,
"is_role_account": false,
"is_catch_all": false,
"domain": "example.com",
"mx_records": ["mx1.example.com"]
}3
Handle the response
Parse the JSON response and use the verification status in your application.
Code Examples
Python
import requests
API_KEY = "YOUR_API_KEY"
email = "test@example.com"
response = requests.get(
"https://api.mailveri.com/v1/verify",
params={"email": email},
headers={"Authorization": f"Bearer {API_KEY}"}
)
result = response.json()
print(f"Status: {result['status']}")
print(f"Is Disposable: {result['is_disposable']}")JavaScript
const API_KEY = 'YOUR_API_KEY';
const email = 'test@example.com';
const response = await fetch(
`https://api.mailveri.com/v1/verify?email=${email}`,
{
headers: {
'Authorization': `Bearer ${API_KEY}`
}
}
);
const result = await response.json();
console.log('Status:', result.status);
console.log('Is Disposable:', result.is_disposable);PHP
<?php
$apiKey = 'YOUR_API_KEY';
$email = 'test@example.com';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,
"https://api.mailveri.com/v1/verify?email=" . urlencode($email));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer " . $apiKey
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$result = json_decode($response, true);
echo "Status: " . $result['status'];
?>API Endpoints
GET
/v1/verifyVerify a single email address
Parameters
email(string)required– Email address to verifyPOST
/v1/verify/batchVerify multiple emails in a batch (up to 100)
Parameters
emails(array)required– Array of email addressesPOST
/v1/listsUpload a file for bulk verification
Parameters
file(file)required– CSV, Excel, or TXT filecolumn(integer)– Column index for emails (default: auto-detect)GET
/v1/lists/{id}Get status and results of a verification job
Parameters
id(string)required– Job ID from uploadGET
/v1/creditsGet current credit balance
Response Status Codes
VALIDEmail exists and can receive messagesINVALIDMailbox does not exist or is disabledDISPOSABLETemporary email addressROLE_ACCOUNTRole-based email (info@, support@)CATCH_ALLDomain accepts all emailsFULL_INBOXMailbox is fullUNKNOWNCould not verifyAuthentication
All API requests require authentication using a Bearer token. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYGet your API key from the MailVeri dashboard.
Ready to integrate?
Get 1,000 free API credits when you sign up. Start building in minutes.