Loading
Loading
Validate and verify email addresses in real time — checks syntax, MX records, domain validity, disposable addresses, catch-all domains, role-based accounts, spam traps, and deliverability.
Send the email address and optional parameters in the request body. The response includes detailed validation results for syntax, domain, DNS, account, and optional IP geolocation and security analysis.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following optional query parameter controls the response format.
formatoptionalstringdefault: jsonResponse format. Possible values are:
The request body must be in JSON format and include an email field along with optional name and ip fields for enrichment:
{
"email": "abc@example.com",
"name": "ABC Person",
"ip": "1.1.1.1"
}emailrequiredStringThe email address to validate.
nameoptionalStringOptional identifier or label for record tracking purposes. Reserved for future identity verification.
ipoptionalStringOptional IP address for geolocation and security enrichment (VPN, proxy, TOR, threat detection).
A successful request returns a 200 OK response with a JSON object containing validation results. Response includes IP enrichment fields only when an IP address is provided.
successIndicates the processing status of the validation request. true: Validation process completed successfully. false: Validation could not be completed due to inconclusive results.
emailThe email address submitted for validation.
nameOptional identifier or label provided in the request for record tracking purposes.
validEmailComprehensive deliverability assessment. Values: valid (recipient confirmed), invalid (rejected or undeliverable), unknown (inconclusive), risky (uncertain deliverability).
reasonDetailed explanation returned when validEmail is not valid.
validSyntaxValidates email address format compliance with RFC 5322 standards. When false, validEmail will always return invalid.
domainDomain-level analysis containing validation status, disposability classification, spam reputation, and catch-all configuration detection.
accountMailbox-level analysis containing role-based address detection and storage capacity status indicators.
dnsDNS record collection containing MX and A records retrieved during validation process.
ipAddressIP address provided for geolocation and security enrichment. Not required for core email validation.
address.locationGeographic location data derived from IP address geolocation services. Included only when ipAddress is provided and successfully resolved.
address.securitySecurity threat intelligence containing proxy detection, bot identification, threat scoring, and anonymization analysis. Included only when ipAddress is provided.
address.validIpAddressValidation status indicating whether the IP address was successfully recognized and resolved by the geolocation service provider.
The domain object contains the following fields:
nameExtracted domain component from the email address.
validDomainDomain validation status confirming DNS resolution capability and mail delivery infrastructure availability.
disposableClassification flag identifying domains registered with known temporary or disposable email service providers.
spamReputation indicator flagging domains that appear on spam databases or suspicious activity monitoring lists.
freeClassification indicating free or consumer-grade email service providers.
catchAllDetection flag for domains configured to accept mail for any recipient address (catch-all MX configuration). Reduces recipient-level validation accuracy.
The account object contains the following fields:
rolePattern detection flag identifying role-based or functional email addresses (e.g. admin@, support@, sales@, info@, contact@).
fullMailBoxStorage capacity status indicator for the recipient mailbox. Returned only when mailbox status can be determined through SMTP response codes.
The dns object contains the following fields:
mxRecordsCollection of MX (Mail Exchange) hostname records retrieved from DNS queries and used during SMTP validation handshake.
aRecordsCollection of A (Address) records for the domain. Contains IPv4 addresses resolved from DNS queries.
The address.location object contains the following fields (included when ip is provided):
cityMunicipal or city name derived from IP geolocation database.
districtDistrict, neighborhood, or sub-municipal administrative division.
zipcodePostal code or ZIP code designation for the location.
state_provState, province, or first-level administrative division designation.
country_nameCommon country name in English.
country_name_officialOfficial country name as recognized by international naming conventions.
country_code2Two-character country identifier (ISO 3166-1 alpha-2).
country_code3Three-character country identifier (ISO 3166-1 alpha-3).
continent_nameContinental region name.
continent_codeContinental region identifier (ISO 3166-1 continent codes).
accuracy_radiusGeolocation precision radius provided by the service provider.
confidenceConfidence score or reliability metric for the geolocation accuracy.
is_euEuropean Union membership status indicator for the identified country.
The address.security object contains the following fields (included when ip is provided):
threat_scoreQuantitative risk assessment score. Higher values indicate elevated security risk.
is_torDetection flag for IP addresses routed through the Tor anonymity network.
is_proxyDetection flag identifying IP addresses operating as proxy servers.
proxy_typeClassification of detected proxy infrastructure type (e.g. VPN, HTTP, SOCKS).
proxy_providerIdentified service provider operating the proxy infrastructure.
is_anonymousAnonymization detection flag for IP addresses using identity obfuscation techniques.
is_known_attackerThreat intelligence flag for IP addresses documented as confirmed malicious sources.
is_spamReputation flag for IP addresses associated with spam transmission.
is_botAutomated traffic detection flag for IP addresses from bot networks.
is_cloud_providerInfrastructure classification flag for IP addresses from cloud computing providers.
cloud_providerIdentified cloud infrastructure or hosting service provider name.
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
Please pass valid value for 'email' in body.
Wrong HTTP method was used on the endpoint.
Timed out while connecting to the remote URL.