Con Verifica Email Start puoi controllare la validità di qualsiasi indirizzo email e accedere ad informazioni come stato della casella, configurazioni SPF e DMARC, provider, indirizzi IP, eventuale presenza di antispam, e non solo.
Il servizio è disponibile a livello globale e in pochi secondi.
ESEMPIO RICHIESTA
POST /email-start/{email}
Per utilizzare il servizio è necessario effettuare una richiesta POST all’endpoint /email-start/{email} passando come parametro l’indirizzo email che si vuole verificare.
In fase di richiesta è possibile e consigliamo sempre di impostare una callback per ricevere una notifica quando la risposta è disponibile.
{
"callback": {
"url": "https://your-server.site/email-callback",
"custom": {
"orderId": "email-check-456"
}
}
}
ESEMPIO RISPOSTA
POST /email-start/{email}
La risposta viene restituita in media in pochi secondi ed include informazioni quali:
- id, necessario in seguito per verificare lo stato della richiesta
- status dell’email (valid, invalid, risky, unknown)
- validità e dettagli delle configurazioni SPF e DMARC
- indicazione se l’email è di un provider gratuito (es. Gmail, Outlook)
- riconoscimento di email temporanee, usa e getta (disposable)
- presenza di dominio catch-all (accetta tutte le email)
- verifica di sistemi antispam attivi sul server di posta
- disponibilità della casella (se piena o meno)
- suggerimenti di correzione in caso di errori nel dominio dell’email
- indicazione se l'indirizzo e-mail è un account basato sul ruolo (ad esempio, admin@, support@, info@)
- verifica indirizzi IP
- data e orario richiesta
- data aggiornamento
- stato richiesta ( NEW, WAIT, DONE)
{
"data": {
"email": "[email protected]",
"validSpf": false,
"validDmarc": true,
"spfDetails": {
"domain": "openapi.com",
"dnsServerUsed": "1.1.1.1",
"queriedDnsForTxt": true,
"selectedSpfRecord": "v=spf1 include:spf.mailtrusted.org include:emsd1.com include:mailgun.org -all",
"formalValidity": {
"startsWithVspf1": true,
"hasValidAllMechanism": false,
"dnsMechanismLookupCount": 10,
"maxDnsMechanismLookups": 10,
"voidLookupCount": 0,
"maxVoidLookups": 2,
"hasRedirectModifier": false,
"redirectDomain": null,
"syntaxErrors": [
"DNS lookup limit at 'include:_spf2.mailgun.org'."
],
"warnings": [],
"explanationDomain": null
},
"parsedMechanisms": [
{
"term": "include:spf.mailtrusted.org",
"mechanism": "include",
"value": "spf.mailtrusted.org",
"qualifier": "+",
"lookupCost": 1,
"isVoidLookup": false,
"ipsFound": [],
"effectiveResultIfMatched": "PASS",
"includedReport": {
"recurse": "all submechanisms included"
}
},
{
"term": "include:emsd1.com",
"mechanism": "include",
"value": "emsd1.com",
"qualifier": "+",
"lookupCost": 1,
"isVoidLookup": false,
"ipsFound": [],
"effectiveResultIfMatched": "PASS",
"includedReport": {
"recurse": "all submechanisms included"
}
}
],
"allMechanismDetails": null,
"collectedIpAddresses": {
"ip4": [
"207.180.201.22",
"207.180.222.205",
"207.180.226.204",
"etc"
],
"ip6": [
"2001:4860:4000::/36",
"2404:6800:4000::/36",
"etc"
],
"fromA": [],
"fromMx": []
},
"summary": {
"totalDnsMechanismLookupsUsed": 10,
"finalProcessingResult": "PERMERROR",
"evaluationLog": []
}
},
"dmarcDetails": {
"recordFound": true,
"record": "v=DMARC1; p=none",
"dnsQueryDomain": "_dmarc.openapi.com",
"dnsServerUsed": "8.8.8.8",
"policy": "none",
"subdomainPolicy": null,
"alignmentDkim": "r",
"alignmentSpf": "r",
"percentage": 100,
"reportingUrisAggregate": [],
"reportingUrisFailure": [],
"failureOptions": [],
"errors": [],
"warnings": []
},
"requestedEmail": "[email protected]",
"createdAt": "2025-05-27T12:58:39+00:00",
"updatedAt": "2025-05-27T12:58:40+00:00",
"state": "NEW",
"id": "6835b6fff6722090d00e74fb"
},
"success": true,
"message": "",
"error": null
}
Nel caso non fosse possibile gestirla entro i primi 10 secondi, verrà restituita una risposta parziale, con stato NEW e l’id per gestire la richiesta in modalità asincrona.
In questo caso sarà necessario effettuare una seconda chiamata per ottenere i dati richiesti.
ESEMPIO RICHIESTA
GET /email-start/{id}
L’endpoint per verificare lo stato della richiesta è /email-start/{id} ed il metodo utilizzato è GET. In caso di implementazione della callback sarete avvertiti quando la vostra richiesta sarà evasa ed i vostri dati disponibili.
Questo è un esempio di richiesta con l’id ottenuto nella precedente chiamata POST:
GET/email-start/77e9e92216065fa37f3c9842
La risposta, nel caso in cui lo stato sia DONE, cioè evaso, restituirà i dati indicati già precedentemente nella risposta alle richiesta in POST.
Verifica Email Start è il servizio ideale per aziende, agenzie di marketing, eCommerce e CRM che vogliono automatizzare la verifica degli indirizzi email. Aiuta a migliorare la qualità delle liste, aumentare la deliverability, proteggere la reputazione del dominio ed eliminare indirizzi non validi, errati o potenzialmente dannosi (spamtrap).