Email Magnifier API service

We developed friendly and easy to use web api. You can accesses to the api from any platform supporting http request.
The api use json format can be used for the request and for the response. You have two options for using our api depending on your needs.
You can check a single email address and retrieve the response synchronously or check many email addresses and retrieve the response asynchronously.
  • Check the single email address
    The UTL: https://www.emailmagnifier.com/api/v1.0/analizeemail
    The header: content-type = 'application/json'
    Request parameters
    Name Type Description
    Email String The email address for test
    AnalyzeAllMXRecords Bool See 'Analyze all MX records' for details.
    TestPosibility Bool See 'Check negative response possibility' for details.
    AuthorizationKey String The user authorization key. You can see your authorization key in My Details page.
    Sample:
                                    {
                                        "Email": "example@server.com",
                                        "AnalyzeAllMXRecords": true,
                                        "TestPosibility": true,
                                        "AuthorizationKey": "a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5"
                                    }
                                
    Response parameters
    See the response structure below.
  • Check many email addresses
    The UTL: https://www.emailmagnifier.com/api/v1.0/analizeemails
    The header: content-type = 'application/json'
    Request parameters
    Name Type Description
    Emails Array of string The array of email addresses for the test, maximum 100000 email addresses.
    ResultURL String This is the URL for sending the response. The response will be sent in POST, the data sent in json format.
    AnalyzeAllMXRecords Bool See 'Analyze all MX records' for details.
    TestPosibility Bool See 'Check negative response possibility' for details.
    AuthorizationKey String The user authorization key. You can see your authorization key in My Details page.
    Sample:
                                    {
                                      "Emails": ["example@server.com","example1@server.com","example2@server.com"],
                                      "ResultURL" : "http://www.returnurl.com",
                                      "AnalyzeAllMXRecords": false,
                                      "TestPosibility": true,
                                      "AuthorizationKey": "a1a1a1a1-b2b2-c3c3-d4d4-e5e5e5e5e5e5"
                                    }
                                
    Response parameters
    The immediate response indicates only that your request has been accepted, the real response will be sent to the URL provided by you for the response. See the response structure below.
    Name Type Description
    Status Integer 1 - successfully, 2 - failed
    Details String When the status value equal 2 (failed), this parameter will include the error description.
    When the status value equal 1 (successfully), this parameter will include the response URL.
    Sample
                                    {
                                        "Status": 1,
                                        "Details": "The results will be sent to the address http://www.returnurl.com"
                                    }
                                
     
  • Response parameters (note that the structure of the response is similar in both options)
    The response may be received immediately if a single email address is checked, or sent to the URL provided if many email addresses are checked.
    Name Type Description
    Status Integer 1 - successfully, 2 - failed
    Details String This parameter has a value only if the Status equal 2 (failed)
    Emails Array of email object When request parameter 'AnalyzeAllMXRecords' is false the 'Emails' array can only contain one value.
    When request parameter 'AnalyzeAllMXRecords' is true the 'Emails' array will contain the amount of values as a quantity of MX records.
    See email object for details.
    Sample:
                                    {
                                        "Status": 1,
                                        "Details": null,
                                        "Emails": 
                                        [
                                            {
                                                "Name": "example@server.com",
                                                "MxRecordName": "gmail-smtp-in.l.google.com",
                                                "IsSyntaxValid": true,            
                                                "IsNegativeResponsePossible": true,
                                                "ConnectionResponse": 
                                                {
                                                    "Code": 220,
                                                    "Reason": "220 mx.google.com ESMTP w65si7692366jaw.122 - gsmtp"
                                                },
                                                "HeloResponse": 
                                                {
                                                    "Code": 250,
                                                    "Reason": "250 mx.google.com at your service"
                                                },
                                                "MailFromResponse": 
                                                {
                                                    "Code": 250,
                                                    "Reason": "250 2.1.0 OK w65si7692366jaw.122 - gsmtp"
                                                },
                                                "RcptToResponse": 
                                                {
                                                    "Code": 550,
                                                    "Reason": "550-5.1.1 The email account that you tried to reach does not exist. Please try"
                                                },
                                                "QuitResponse": 
                                                {
                                                    "Code": 550,
                                                    "Reason": "550-5.1.1 double-checking the recipient's email address for typos or"
                                                }
                                                "Rank":
                                                {
                                                    "Code": 0,
                                                    "Reason": "The email address exist.",
                                                    "Recommendation": "The email address exist."
                                                }
                                            }
                                        ]
                                    }
                                
     
  • Email object
    The object contains detailed information about checking an email address by MX record
    Email object parameters
    Name Type Description
    MxRecordName String See the MX record.
    Name String This checking email address.
    IsSyntaxValid Bool Indication about the checking email address syntax
    IsNegativeResponsePossible Bool When the value is 'true' the server can return a real response about the email address.
    When the value is 'false' you can not trust this server response.
    See 'Check negative response possibility' for details.
    Rank Integer See 'Email rank' for details.
    ConnectionResponse Object See 'Connect' for details.
    HeloResponse Object See 'HELO' for details.
    MailFromResponse Object See 'MAIL FROM' for details.
    RcptToResponse Object See 'RCPT TO' for details.
    QuitResponse Object See 'QUIT' for details.
    Sample:
                                    {
                                        "MxRecordName": "gmail-smtp-in.l.google.com",
                                        "IsNegativeResponsePossible": true,
                                        "IsSyntaxValid": true,
                                        "Rank": 4,
                                        "Name": "example@server.com",
                                        "ConnectionResponse": 
                                        {
                                            "Code": 220,
                                            "Reason": "220 mx.google.com ESMTP w65si7692366jaw.122 - gsmtp"
                                        },
                                        "HeloResponse": 
                                        {
                                            "Code": 250,
                                            "Reason": "250 mx.google.com at your service"
                                        },
                                        "MailFromResponse": 
                                        {
                                            "Code": 250,
                                            "Reason": "250 2.1.0 OK w65si7692366jaw.122 - gsmtp"
                                        },
                                        "RcptToResponse": 
                                        {
                                            "Code": 550,
                                            "Reason": "550-5.1.1 The email account that you tried to reach does not exist. Please try"
                                        },
                                        "QuitResponse": 
                                        {
                                            "Code": 550,
                                            "Reason": "550-5.1.1 double-checking the recipient's email address for typos or"
                                        }
                                    }
                                
  • Code samples