API docs

Making requests

GEThttps://reverse-mx-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&mx=smtp.secureserver.net

It takes up to 2 minutes to activate your account after Sign Up.

Input parameters

apiKey
Required. Get your personal API KEY on My products page.
mx
Required. Mail server.
from
Optional. The domain name which is used as an offset for the results returned.

Since every response is limited to 300 records, you can retrieve the next page by putting the last domain name from the response into this parameter. For example, if the last domain name in the response is test.com and the field "size" equals 300, in order to retrieve the next page, call

https://reverse-mx-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&ip=8.8.8.8&from=test.com
outputFormat
Optional. Response output format.

Acceptable values: JSON | XML

Default: JSON

Free access

After Sign Up you automatically get a free subscription plan limited to 100 DRS credits.

Sample output

                            {
    "result": [
        {
             "name": "mabizsolution.com",
             "first_seen": "1530519178",
             "last_visit": "1531130222"
        },
        {
             "name": "jakafajnadomena.pl",
             "first_seen": "1530567776",
             "last_visit": "1531123015"
        },
        {
             "name": "teenchallengetm.ro",
             "first_seen": "1530553182",
             "last_visit": "1531153848"
        },
        {
             "name": "chu.com.br",
             "first_seen": "1530476100",
             "last_visit": "1531093213"
        },
        {
             "name": "improveshoppingcart.com",
             "first_seen": "1530507253",
             "last_visit": "1531120195"
        }
    ],
    "current_page": 1,
    "size": 5
}
                            
                        
result
Segment contains info about resulting data, in this case MX.
result[0].name
Domain name
result[0].first_seen
Timestamp of the first time that the record was seen.
result[0].last_visit
Timestamp of the last update for this record.
current_page
Selected page
size
Number of records in result segment.

Account balance information

GEThttps://user.whoisxmlapi.com/service/account-balance?apiKey=YOUR_API_KEY
apiKey
Required. Get your personal API KEY on My products page.
productId
Optional. A list of the products' IDs can be found in the response.

- You can always check your account balance on the My products page. - Note that the following products use the same WHOIS credits: WHOIS API, Bulk WHOIS API, Domain Availability API. - Note that the following products use the same Domain Research Suite credits: Brand Alert API, Registrant Alert API, Reverse WHOIS API, WHOIS History API, Reverse IP/DNS API, Reverse MX API, Reverse NS API.

List of possible errors

403 Forbidden
Access restricted. Check credits balance or enter the correct API key.
422 Unprocessable Entity
Input correct mail server address.
429 Too Many Requests
Too Many Requests. Try your call again later.
5XX
Internal server error. Try your call again or contact us.
Try our Reverse MX API for free
Get started
Have questions?

We work hard to improve our services for you. As part of that, we welcome your feedback, questions and suggestions. Please let us know your thoughts and feelings, and any way in which you think we can improve our product.

For a quick response, please select the request type that best suits your needs. For more info regarding the request types, see the Contact us page.

Or shoot us an email to