Email Verify
/api/v3/email/verify
Email Verify: This endpoint provides a way to verify an email address; that is, it confirms whether or not the provided email address is valid. Once verified, the service returns a list of items with all the details pertaining to the verified email.
The API accepts the following inputs:
1. Email ID - Address to be verified.
2. Timeout - Wait time, in ms, for the service to complete (optional).
The output is a JSON object containing a list of items which is in turn a JSON map of fields; all field values are represented as Strings.
Cost: Unless the API is not accessible for some reason, the user is charged for the service.
Functionality: Each input is a query parameter and output is a JSON list of items. The fields are described in the following table.
| Name | Example | Description |
|---|---|---|
ResponseCode | Valid | Valid - The email address has been fully validated (including the account portion) Valid_CatchAll - The domain has been validated but the account could not be validated Invalid - The email address is invalid and shouldn't be accepted Timeout - The validation could not be completed within the timeout specified (try increasing the timeout value) |
ResponseMessage | Email address was fully validated | A textual description of the ResponseCode returned. |
EmailAddres | testing@test123.com | The email address that verification was attempted on. |
UserAccount | Testing | The account portion of the email address provided. |
Domain | test123.com | The domain portion of the email address provided. |
IsDisposableOrTemporary | False | Whether the email address provided is a disposable mailbox. (Some companies create temporary mailboxes that shouldn't be used for marketing communication.) |
IsComplainerOrFraudRisk | True | True if we recognise the email address against known lists of complainers and/or the email address has been used to defraud. |
Duration | 0.022430881 | The duration (in seconds) that the email validation took (maximum timeout enforced at 15 seconds). We recommend a high timeout (at least 5 seconds) value as it will minimise the number of "Timeout" responses returned. |
Example Response
{
"Items": [
{
"ResponseCode": "Valid",
"ResponseMessage": "Email address was fully validated",
"EmailAddress": "abc@xyz.com",
"UserAccount": "abc",
"Domain": "xyz.com",
"IsDisposableOrTemporary": "false",
"IsComplainerOrFraudRisk": "false",
"Duration": "0.022430881",
"type": "email"
}
]
}
Request
There's no request body for this operation.
Back to TopResponse
- application/json; charset=UTF-8
200 Response
object