API Documentation
Integrate email verification into your application in minutes. Simple REST API with comprehensive examples.
Interactive REST API Docs
Explore detailed endpoint specifications, batch upload guides, webhook signatures, error codes, and code samples in cURL, Python, Node.js, and Go.
Model Context Protocol (MCP) Docs
Connect MailVeri directly into AI assistants like Claude Desktop, Cursor, Windsurf, Claude Code, and Antigravity with one-click setup.
Quick Start
Make your first request
Use the API endpoint with your key to verify any email address.
# Single email verification
curl -X POST "https://api.mailveri.com/v1/verify-mail/" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "[email protected]"
# Response
{
"error": 0,
"message": "Verified [email protected] successfully",
"status": "VALID",
"mail": "[email protected]",
"balance": 999
}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 = "[email protected]"
response = requests.post(
"https://api.mailveri.com/v1/verify-mail/",
data={"mail": email},
headers={"Authorization": f"Bearer {API_KEY}"}
)
result = response.json()
print(f"Status: {result['status']}")
print(f"Remaining Credits: {result['balance']}")JavaScript
const API_KEY = 'YOUR_API_KEY';
const email = '[email protected]';
const formData = new FormData();
formData.append('mail', email);
const response = await fetch(
'https://api.mailveri.com/v1/verify-mail/',
{
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`
},
body: formData
}
);
const result = await response.json();
console.log('Status:', result.status);
console.log('Remaining Credits:', result.balance);PHP
<?php
$apiKey = 'YOUR_API_KEY';
$email = '[email protected]';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.mailveri.com/v1/verify-mail/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['mail' => $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'];
echo "Balance: " . $result['balance'];
?>API Endpoints
/v1/verify-mail/Verify a single email address in real time
Parameters
/v1/verify-mails/Upload a file for distributed bulk verification across worker cluster
Parameters
file(file)required– Text (.txt) or CSV (.csv) file with one email per line (min 2 emails, max 100MB)/v1/get-status/Get verification progress percentage and result download link
Parameters
id(string)required– Job ID returned from /v1/verify-mails//v1/download-result/Download compressed ZIP archive containing categorized verification results
Parameters
id(string)required– Job ID from /v1/verify-mails//v1/get-balance/Get current account credit balance
/v1/delete-list/Cancel an active verification or delete a completed list from storage
Parameters
id(string)required– Job ID from /v1/verify-mails/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.