Email Validation API
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.
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 | 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 |
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 | Max Version |
|---|---|---|---|---|
| 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 |