- Making Requests
GET http://testmail.com/API_Run_One_Test_Single_Email.php?mode=MODE_CODE&email=INPUT_EMAIL
- Input Parameters (required)
mode: The tests to be performed (Allowable values: syntax, domain, MX, SMTP, disposable, RBL, parse)
email: The input email address to be checked
- Error Messaage
{"Error_Message":"Both mode and email are required input parameters"}
- Examples
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=syntax&email=JohnDoe@RandomDomain.com
{"Syntax_Test_Result": {"syntax_is_correct": true}}
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=domain&email=JohnDoe@RandomDomain.com
{"Domain_Test_Result": {"found_matching_domain": true, "domain": "RandomDomain.com"}}
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=MX&email=JohnDoe@RandomDomain.com
{"DNS_MX_Test_Result": {"MX_records": [], "found_MX_records": false}}
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=SMTP&email=JohnDoe@RandomDomain.com
{"SMTP_Test_Result": {"found_SMTP_mailbox": 3}}
Note:
The all possible values of "found_SMTP_mailbox" are:
1 - The response from SMTP server indicated that the mailbox under test exists.
2 - The response from SMTP server indicated that the mailbox under test does not exist.
3 - The response from SMTP server was received. The SMTP mailbox check timeout.
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=disposable&email=JohnDoe@RandomDomain.com
{"Disposable_Test_Result": {"found_in_disposable_email_lists": false}}
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=RBL&email=JohnDoe@RandomDomain.com
{"RBL_Test_Result": {"found_in_RBL_lists": false}}
http://testmail.com/API_Run_One_Test_Single_Email.php?mode=parse&email=JohnDoe@RandomDomain.com
{
"Email_Parse_Test_Result":
{
"first_name": "John",
"last_name": "Doe",
"num": "",
"last_initial": "",
"first_initial": "",
"gender": "Male",
"email_format": "",
"suffix": ""
}
}