Email Validation API

AI Tools

IDENTIFY BAD EMAILS WITH OUR EMAIL ADDRESS VALIDATION SERVICE FOR ZERO BOUNCE RATE AND SPAM PROTECTION

API Outcome

Group / role based email identification Mails sent to group and role based email addresses are associated with higher chances of being ignored, bounced by mail server or tagged as spam. Fine tune your email leads database by filtering such emails.
Disposable mailbox protection Disposable emails are one time temporary email address typically used by spammers and are self destructed after a certain time. Mails sent to disposed mailboxes are almost certainly bounced.
Delivery status projection Validate email deliverability upfront by classifying addresses into success, failure, avoid and unknown delivery status categories and reduce bounce rate up to 90 percent for targeted delivery.
Risk level assessment Sending emails to high risk email addresses affects your domain's reputation and may lead to being tagged as spam sender by leading mail servers. Access the risk level of recipient mailbox before sending.
Auto suggestion Never lose a lead due to spelling errors in email addresses. Our auto suggestion feature recommends closest valid potential match in case a typo is detected.

The legacy data processing model is being formally deprecated.

In order to ensure continued compliance with the Digital Personal Data Protection Act, 2023 (DPDP Act), we are implementing DPDP V3 (Consent-Driven Processing). Under this framework, clients are required to obtain explicit, informed, and verifiable consent from the data principal prior to accessing, processing, viewing, or storing any personal data through the platform. This regulatory transition may require modifications to existing configurations and workflows. Clients are advised to review and update their implementations to ensure ongoing compliance with applicable data protection obligations. Further information regarding this transition can be enquired here. Learn more about this change here.

Single Email Validation API Details

Request

Type	URL
POST	https://api.attestr.com/api/`{version}`/public/checkx/email

Request Body Parameters

Type	Name	Description	Optional (default)	Min Version	Max Version
String	email	Input email to be verified	Required	v1

Request Header Parameters

Type	Name	Value / Description	Optional	Min Version	Max Version
String	Content-Type	application/json	Required	v1
String	Authorization	Basic `{authToken}`	Required	v1

Info

If you do not have the authentication token, please refer to Register App to generate one.

Sample Request

{ "email": "pingpong@qpalong.com" }

Response

HTTP status code 200

Key	Description	Type	Min Version
email	Input email as requested	String	v1
disposable	True \| false depending of whether the provided email is a temporary self destructive one time email	Boolean	v1
role	True \| false depending of whether the provided email is a group or role based email address	Boolean	v1
deliverable	Category specifying if email is deliverable, non deliverable, avoid or unknown	EmailValidationStatusEnum	v1
risk	Reputation risk level associated with the provided email	EmailValidationRiskEnum	v1
tags	List of tags associated with the provided email	Array of EmailValidationErrorEnum	v1

EmailValidationStatusEnum

Enum Values	Description
SUCCESS	The email should get delivered without any issues.
FAIL	Email is highly likely to bounce / fail.
AVOID	Tagged as high risk. Sending email to this address might impact the sender's reputation
CATCHALL	Mailing provider accepts all emails regardless of whether or not the recipient’s mailbox exists
UNKNOWN	Delivery status could not be determined

EmailValidationRiskEnum

Enum Values	Description
HIGH	Strongly not recommended to send
MEDIUM	Moderate risk associated
LOW	Categorized as low or no risk, generally safe to send
UNKNOWN	Risk status could not be determined

EmailValidationErrorEnum

Enum Values	Description
MX-NEW	Newly listed domain in WHOIS database
MX-ROLE	Role/Group based mailbox distribution list
MX-DISPOSABLE	Mailbox listed as disposable / temporary
MX-HIGHRISKDOMAIN	Mailbox domain is known high risk listed
MX-SUBDOMAIN	Subdomain recipient categorized as high risk
MX-UNKNOWN	Unknown mailbox provider / identity could not be established
MX-CATCHALL	Mailing provider accepts all emails regardless of whether or not the recipient’s mailbox exists

Sample Response

{ "email": "pingpong@qpalong.com", "disposable": true, "role": false, "tags": [ "MX-DISPOSABLE" ], "deliverable": "AVOID", "risk": "HIGH" }

Error Response

Parameter	Type	Description
code	Number	Unique error codes for different errors. Always available.
message	String	Error message describing the error. Always Available.
details	String	Detail error message. Available only for certain types of errors.

Sample Error Response

{ "code": 4001, "message": "Malformed data or missing required parameter values" }

Error Codes

HTTP Status	Error Code	Error Message
400	4001	Malformed data or missing required parameter values
400	4005	Operation could not be performed due to low credits balance
401	4016	Invalid client authorization
403	4031	Unauthorized access
403	4035	Requested service is not provisioned for your account
403	4039	Client's IP address is not whitelisted
403	4035	Requested service is not provisioned for your account
429	4291	Maximum account rate limit exceeded
429	4292	Maximum API rate limit exceeded
429	4293	Maximum account daily limit exceeded
429	4294	Maximum API daily limit exceeded
500	5001	Request could not be processed

Last updated on Feb 3, 2026