Loading
https://api.apifreaks.com/v1.0/email-validation/single
$ pip install requests
Click Test it to start the request and see the response here!
| Field | Type | Requirement | Description |
|---|---|---|---|
| success | Boolean | Mandatory | Indicates the processing status of the validation request. true: Validation process completed successfully, regardless of whether validEmail is invalid or risky.false: Validation could not be completed due to inconclusive results or blocked validation path (typically occurs when validEmail returns unknown). |
| String | Mandatory | The email address submitted for validation. | |
| name | String | Optional | Optional identifier or label provided in the request for record tracking purposes. |
| validEmail | String | Mandatory | Comprehensive deliverability assessment derived from SMTP protocol validation, DNS record verification, and email provider-specific fallback mechanisms. Possible values: • valid - Email address verified and recipient confirmed to exist• invalid - Email address rejected by recipient server or domain is undeliverable• unknown - Validation inconclusive due to server non-response, temporary blocks, or probe restrictions (results in success: false)• risky - Deliverability uncertain due to greylisting, mailbox capacity issues, or other temporary conditions |
| reason | String | Optional | Detailed explanation returned when validEmail is not valid. |
| validSyntax | Boolean | Mandatory | Validates email address format compliance with RFC 5322 standards. When false, the validEmail field will always return invalid. |
| domain | Object | Mandatory | Domain-level analysis containing validation status, disposability classification, spam reputation, and catch-all configuration detection. |
| account | Object | Mandatory | Mailbox-level analysis containing role-based address detection and storage capacity status indicators. |
| dns | Object | Mandatory | DNS record collection containing MX and A records retrieved during validation process. |
| ipAddress | String | Optional | IP address provided for geolocation and security enrichment. This field is not required for core email validation functionality. |
| address.location | Object | Optional | Geographic location data derived from IP address geolocation services. Included only when ipAddress is provided and successfully resolved by geolocation provider. |
| address.security | Object | Optional | Security threat intelligence containing proxy detection, bot identification, threat scoring, and anonymization analysis. Included only when ipAddress is provided and successfully resolved. |
| address.validIpAddress | Boolean | Optional | Validation status indicating whether the IP address was successfully recognized and resolved by the geolocation service provider. |
"domain" Object contains the following fields:
| Field | Type | Requirement | Description |
|---|---|---|---|
| name | String | Mandatory | Extracted domain component from the email address. |
| validDomain | Boolean | Mandatory | Domain validation status confirming DNS resolution capability and mail delivery infrastructure availability. Verification includes presence and usability of MX (Mail Exchange) records. |
| disposable | Boolean | Mandatory | Classification flag identifying domains registered with known temporary or disposable email service providers. |
| spam | Boolean | Mandatory | Reputation indicator flagging domains that appear on spam databases or suspicious activity monitoring lists. |
| free | Boolean | Mandatory | Classification indicating free or consumer-grade email service providers. |
| catchAll | Boolean | Mandatory | Detection flag for domains configured to accept mail for any recipient address (catch-all MX configuration). Reduces recipient-level validation accuracy and increases deliverability uncertainty. |
"account" Object contains the following fields:
| Field | Type | Requirement | Description |
|---|---|---|---|
| role | Boolean | Mandatory | Pattern detection flag identifying role-based or functional email addresses. e.g. admin@, support@, sales@, info@, contact@ |
| fullMailBox | Boolean | Optional | Storage capacity status indicator for the recipient mailbox. Returned only when mailbox status can be determined through SMTP response codes. Omitted when status is indeterminable. |
"dns" Object contains the following fields:
| Field | Type | Requirement | Description |
|---|---|---|---|
| mxRecords | Array<String> | Mandatory | Collection of MX (Mail Exchange) hostname records retrieved from DNS queries and utilized during SMTP validation handshake process. |
| aRecords | Array<String> | Optional | Collection of A (Address) records for the domain. Contains IPv4 addresses resolved from DNS queries for the target domain. |
"address.location" Object contains the following fields:
| Field | Type | Requirement | Description |
|---|---|---|---|
| city | String | Mandatory | Municipal or city name derived from IP geolocation database. |
| district | String | Optional | District, neighborhood, or sub-municipal administrative division. Included when provider database contains granular location data. |
| zipcode | String | Mandatory | Postal code or ZIP code designation for the location. |
| state_prov | String | Mandatory | State, province, or first-level administrative division designation. |
| country_name | String | Mandatory | Common country name in English. |
| country_name_official | String | Mandatory | Official country name as recognized by international naming conventions. |
| country_code2 | String | Mandatory | Two-character country identifier. Standard: ISO 3166-1 alpha-2 |
| country_code3 | String | Mandatory | Three-character country identifier. Standard: ISO 3166-1 alpha-3 |
| continent_name | String | Mandatory | Continental region name. |
| continent_code | String | Mandatory | Continental region identifier. Standard: ISO 3166-1 continent codes |
| accuracy_radius | String | Mandatory | Geolocation precision radius provided by the service provider. Typically expressed in kilometers or miles depending on provider configuration. |
| confidence | String | Mandatory | Confidence score or reliability metric for the geolocation accuracy, as determined by the provider algorithm. |
| is_eu | Boolean | Mandatory | European Union membership status indicator for the identified country. |
"address.security" Object contains the following fields:
| Field | Type | Requirement | Description |
|---|---|---|---|
| threat_score | Number | Mandatory | Quantitative risk assessment score calculated from threat intelligence data sources. Higher values indicate elevated security risk and potentially malicious activity patterns. |
| is_tor | Boolean | Mandatory | Detection flag for IP addresses routed through the Tor (The Onion Router) anonymity network. |
| is_proxy | Boolean | Mandatory | Detection flag identifying IP addresses operating as proxy servers or intermediary connection points. |
| proxy_type | String | Mandatory | Classification of detected proxy infrastructure type. e.g. VPN, HTTP, SOCKS, Web Proxy, Public Proxy |
| proxy_provider | String | Mandatory | Identified service provider operating the proxy infrastructure. Typically populated for commercial VPN services and known proxy providers. |
| is_anonymous | Boolean | Mandatory | Anonymization detection flag identifying IP addresses employing identity obfuscation techniques or privacy-enhancing technologies. |
| is_known_attacker | Boolean | Mandatory | Threat intelligence flag identifying IP addresses documented in attack databases as confirmed sources of malicious network activity. |
| is_spam | Boolean | Mandatory | Reputation flag identifying IP addresses associated with spam transmission or listed in anti-spam blacklist databases. |
| is_bot | Boolean | Mandatory | Automated traffic detection flag identifying IP addresses originating from bot networks, scripts, or non-human traffic sources. |
| is_cloud_provider | Boolean | Mandatory | Infrastructure classification flag identifying IP addresses allocated to cloud computing or hosting service providers. |
| cloud_provider | String | Mandatory | Identified cloud infrastructure or hosting service provider name. |