/v1/email-verification/{email}
Verify an email address
Verifies an email address. result is safe (deliverable), risky (deliverable but uncertain), invalid (not deliverable) or unknown (cannot be determined, not billed). reason states why: accepted, catch_all, role_account, disposable, invalid_syntax, invalid_domain, null_mx, rejected, low_quality, unverifiable, processing_objected (the person concerned has objected to the processing of their data) or dns_unavailable. checks contains the individual checks (syntax, mail server, mail provider, disposable domain, role address, catch-all). The existing fields remain: status is valid if mail can be sent to the address, otherwise risky, invalid, disposable or unknown. source shows where the result comes from: DB (stored result), NA (own check) or a verification service (LR, HU, EA). The API answers a syntactically invalid address with HTTP 400.
Bearer fd_… 9.00 EUR per 1,000 successful requests
Path parameters
| Name | Type | Description | |
|---|---|---|---|
| string | Email address to verify |
curl -X GET "https://api.flowdata.one/v1/email-verification/max@example.com" \
-H "Authorization: Bearer fd_YOUR_KEY" \
-H "Accept: application/json"
use Illuminate\Support\Facades\Http;
$response = Http::withToken('fd_YOUR_KEY')
->get('https://api.flowdata.one/v1/email-verification/max@example.com');
$data = $response->json();
const response = await fetch('https://api.flowdata.one/v1/email-verification/max@example.com', {
method: 'GET',
headers: {
'Authorization': 'Bearer fd_YOUR_KEY',
'Accept': 'application/json',
},
});
const data = await response.json();
import requests
headers = {
'Authorization': 'Bearer fd_YOUR_KEY',
'Accept': 'application/json',
}
response = requests.get(
'https://api.flowdata.one/v1/email-verification/max@example.com',
headers=headers,
)
data = response.json()
{
"email_address": "user@example.com",
"status": "valid",
"source": "NA",
"result": "risky",
"reason": "catch_all",
"checks": {
"syntax": true,
"mx": "ok",
"mail_provider": "other",
"disposable": false,
"role_account": false,
"catch_all": true
}
}