curl --request GET \
--url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '9d4fa0ed-f76b-409f-bee4-d5468ebda70e';
const response = await fetch(`https://api.enrow.io/email/verify/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "9d4fa0ed-f76b-409f-bee4-d5468ebda70e"
url = f"https://api.enrow.io/email/verify/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
"status": "completed"
},
"results": [
{
"email": "pam.beesly@dundermifflin.com",
"index": "195f87c6-376e-4eca-9861-f92935413b0c",
"qualification": "valid"
},
{
"email": "angela.martin@dundermifflin.com",
"index": "662784ae-3722-47af-b056-7554e013f73b",
"qualification": "valid"
}
],
"stats": {
"credits_cost": 0.5,
"requested": 2,
"valid": 2
}
}
{
"message": "..."
}
Email Verifier
Recupera verifiche
Recupera i risultati della verifica di email in blocco tramite ID batch, inclusi validità per email, stato del batch e crediti utilizzati
GET
/
email
/
verify
/
bulk
curl --request GET \
--url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '9d4fa0ed-f76b-409f-bee4-d5468ebda70e';
const response = await fetch(`https://api.enrow.io/email/verify/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "9d4fa0ed-f76b-409f-bee4-d5468ebda70e"
url = f"https://api.enrow.io/email/verify/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
"status": "completed"
},
"results": [
{
"email": "pam.beesly@dundermifflin.com",
"index": "195f87c6-376e-4eca-9861-f92935413b0c",
"qualification": "valid"
},
{
"email": "angela.martin@dundermifflin.com",
"index": "662784ae-3722-47af-b056-7554e013f73b",
"qualification": "valid"
}
],
"stats": {
"credits_cost": 0.5,
"requested": 2,
"valid": 2
}
}
{
"message": "..."
}
GET
Recupera tutti i risultati di una verifica di email in blocco utilizzando l’ID del batch. Autentica ogni richiesta con la tua chiave API nell’header
Vedi Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta.
https://api.enrow.io/email/verify/bulk?id={id}
x-api-key. Per avviare prima un batch, utilizza l’endpoint Verify Bulk Emails.
L’utilizzo di un webhook ti consente di evitare la chiamata a questo endpoint GET. Vedi How Webhooks Work.
Parametri di query
string
obbligatorio
L’
id restituito dalla richiesta POSTRisposta
200 — Verifica completata
object
object
Statistiche del batch
Mostra proprietà di stats
Mostra proprietà di stats
number
Totale dei crediti consumati. Vedi Crediti e fatturazione per i costi per endpoint.
number
Numero totale di verifiche richieste
number
Numero di email valide
array
Array dei risultati della verifica
Mostra proprietà dei risultati
Mostra proprietà dei risultati
string
L’indirizzo email verificato
string
Identificatore univoco di questa verifica all’interno del batch
string
valid (recapitabile) o invalid (non recapitabile). Perché binario?200 — Verifica ancora in corso
Mentre il batch è ancora in esecuzione, l’endpoint restituisce HTTP200 con lo stato del batch anziché i risultati completi.
object
Risposte di errore
| Codice | Messaggio |
|---|---|
| 400 | Could not retrieve bulk verification results |
curl --request GET \
--url 'https://api.enrow.io/email/verify/bulk?id=9d4fa0ed-f76b-409f-bee4-d5468ebda70e' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '9d4fa0ed-f76b-409f-bee4-d5468ebda70e';
const response = await fetch(`https://api.enrow.io/email/verify/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "9d4fa0ed-f76b-409f-bee4-d5468ebda70e"
url = f"https://api.enrow.io/email/verify/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "9d4fa0ed-f76b-409f-bee4-d5468ebda70e",
"status": "completed"
},
"results": [
{
"email": "pam.beesly@dundermifflin.com",
"index": "195f87c6-376e-4eca-9861-f92935413b0c",
"qualification": "valid"
},
{
"email": "angela.martin@dundermifflin.com",
"index": "662784ae-3722-47af-b056-7554e013f73b",
"qualification": "valid"
}
],
"stats": {
"credits_cost": 0.5,
"requested": 2,
"valid": 2
}
}
{
"message": "..."
}
Passaggi successivi
Verifica email in blocco
Avvia una verifica batch e ottieni l’
id del batch.Verifica una singola email
Controlla se un singolo indirizzo email è valido e recapitabile.
Webhooks
Ricevi una notifica automatica al completamento di un batch invece di effettuare polling.
Crediti e fatturazione
Scopri come vengono consumati i crediti per ciascun endpoint.
Questa pagina è stata utile?

