Stuur een array van e-mailadressen (max. 25) en ontvang per adres een validatieresultaat. Elk adres wordt gecheckt op RFC-formaat, DNS en MX-records. De response bevat een samenvatting met valid_count en invalid_count.
Valideer een geüpload CSV-bestand met e-mailadressen voordat je ze opslaat in je CRM.
Verwerk een bestaande mailinglijst in batches van 25 om ongeldige adressen te identificeren.
Je kunt per request maximaal 25 e-mailadressen meesturen. Voor grotere lijsten kun je meerdere requests na elkaar uitvoeren.
Wij denken graag mee over oplossingen voor grotere batches. Neem contact op met ons supportteam voor advies op maat.
De overige adressen worden gewoon verwerkt. Elk adres in de results-array heeft zijn eigen valid-veld en checks-object.
Integreren in jouw applicatie? Probeer onze codevoorbeelden hieronder of bekijk de volledige documentatie voor meer details en extra talen en/of collecties.
curl --request POST \
--url "https://api.getapi.nl/api/v1/validate/email/batch" \
--header "X-Api-Key: ga_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data '{"emails":["[email protected]","[email protected]"]}'
const body = {
"emails": [
"[email protected]",
"[email protected]"
]
};
const response = await fetch('https://api.getapi.nl/api/v1/validate/email/batch', {
method: 'POST',
headers: {
'X-Api-Key': 'ga_live_YOUR_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify(body),
});
const data = await response.json();
$ch = curl_init();
$headers = [
'X-Api-Key: ga_live_YOUR_KEY',
'Accept: application/json',
'Content-Type: application/json',
];
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.getapi.nl/api/v1/validate/email/batch',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => '{"emails":["[email protected]","[email protected]"]}',
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
import requests
headers = {
'X-Api-Key': 'ga_live_YOUR_KEY',
}
payload = {
'emails': ["[email protected]","[email protected]"],
}
response = requests.post('https://api.getapi.nl/api/v1/validate/email/batch', json=payload, headers=headers)
data = response.json()
{
"total": 2,
"valid_count": 1,
"invalid_count": 1,
"results": [
{
"valid": true,
"email": "[email protected]",
"checks": {
"format": true,
"domain_exists": true,
"has_mx_record": true
},
"message": "Email address appears valid."
},
{
"valid": false,
"email": "invalid@",
"checks": {
"format": false,
"domain_exists": false,
"has_mx_record": false
},
"message": "Invalid email format."
}
]
}
Overzicht van alle velden die de API teruggeeft in een succesvol antwoord.
| Veld | Type | Verplicht | Omschrijving |
|---|---|---|---|
total
|
integer | ja | |
valid_count
|
integer | ja | |
invalid_count
|
integer | ja | |
results
|
array | ja | |
└ valid
|
boolean | ja | |
└ email
|
string | ja | |
└ checks
|
object | ja | |
└ format
|
boolean | ja | |
└ domain_exists
|
boolean | ja | |
└ has_mx_record
|
boolean | ja | |
└ message
|
string | ja |
| Tier | Rate limit | Kosten per call |
|---|---|---|
| Gratis | 5 verzoeken/min | 1.00 credit |
| Betaald | 120 verzoeken/min | 1.00 credit |
| Premium | 120 verzoeken/min | 1.00 credit |
Credits worden afgeschreven per succesvol verzoek. Bekijk onze prijzen voor meer informatie over creditpakketten.
Documentatie & codevoorbeelden
Bekijk de volledige API-referentie met authenticatie, endpoints en automatisch gegenereerde codevoorbeelden in cURL, PHP, JavaScript en Python.