MxToolbox
34 min
the mxtoolbox connector integrates with swimlane to lookup a, dns, mx, ptr, soa, spf, and txt records bundle will list mx records for a domain in priority order, lookup is done directly against the domain's authoritative name server, so changes to mx records should show up instantly prerequisites the connector requires an api key to use the mxtoolbox asset you can get one here https //mxtoolbox com/user/api/lookup aspx after creating an account capabilities the mxtoolbox connector provides the following capabilities a record lookup dns record lookup mx record lookup ptr record lookup soa record lookup spf record lookup txt record lookup configurations api key authentication authenticates using an api key configuration parameters parameter description type required url a url to the target host string required apikey api key string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional actions a record lookup a record lookup endpoint url /lookup/a/{{search host}}/ method get input argument name type required description search host string required host where you want to do the lookups output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information type string type of the resource domain name string name of the resource ip address string output field ip address ttl string output field ttl asn string output field asn isipv6 string output field isipv6 transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned commandargument string output field commandargument timerecorded string output field timerecorded reportingnameserver string name of the resource timetocomplete string output field timetocomplete relatedip object output field relatedip example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "3392", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 37 21 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 94986b83e071fcce0c0003c6ea656778 cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" " a\ mxtoolbox com\r\n\r\n\  1 a gtld servers net 192 5 6 30 non auth 10 ms r ", "uid" null, "command" "a", "istransitioned" false, "commandargument" "mxtoolbox com", "timerecorded" "2023 11 20t03 37 20 5869833 06 00", "reportingnameserver" "ns 1320 awsdns 37 org", "timetocomplete" "31", "relatedip" null, "isendpoint" false, "hassubscriptions" false } } ] dns record lookup dns record lookup endpoint url /lookup/dns/{{search host}}/ method get input argument name type required description search host string required parameter for dns record lookup output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information type string type of the resource domain name string name of the resource ip address string output field ip address ttl string output field ttl status string status value time (ms) string output field time (ms) auth string output field auth parent string output field parent local string output field local asn string output field asn isipv6 string output field isipv6 transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "10370", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 39 23 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 d3e1512c907d4148b6f23b17e3e151ea cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" "\r\nlookupserver 651ms\r\n,1,f gtld servers net,192 35 51 30,non auth,38 ms,received ", "uid" null, "command" "dns", "istransitioned" false, "commandargument" "mxtoolbox com", "timerecorded" "2023 11 20t03 39 21 9489842 06 00", "reportingnameserver" "ns 495 awsdns 61 com", "timetocomplete" "651", "relatedip" null, "isendpoint" false, "hassubscriptions" false } } ] mx record lookup lookup mx record endpoint url /lookup/mx/{{search host}}/ method get input argument name type required description search host string required parameter for mx record lookup output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information pref string output field pref hostname string name of the resource ip address string output field ip address ttl string output field ttl asn string output field asn isipv6 string output field isipv6 transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned commandargument string output field commandargument timerecorded string output field timerecorded reportingnameserver string name of the resource timetocomplete string output field timetocomplete relatedip object output field relatedip example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "3340", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 41 45 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 a78b6059371e72adb6c9a5728e8f07bc cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" " mx\ google com\r\n\r\n\  1 g gtld servers net 192 42 93 30 non auth 24 ms r ", "uid" null, "command" "mx", "istransitioned" false, "commandargument" "google com", "timerecorded" "2023 11 20t03 41 45 3827589 06 00", "reportingnameserver" "ns2 google com", "timetocomplete" "114", "relatedip" null, "isendpoint" false, "hassubscriptions" false } } ] ptr record lookup lookup ptr record endpoint url /lookup/ptr/{{search host}}/ method get input argument name type required description search host string required parameter for ptr record lookup output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information type string type of the resource ip address string output field ip address domain name string name of the resource ttl string output field ttl asn string output field asn isipv6 string output field isipv6 transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned commandargument string output field commandargument timerecorded string output field timerecorded reportingnameserver string name of the resource timetocomplete string output field timetocomplete relatedip string output field relatedip example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "3159", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 43 58 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 1702d8d109f57158ae6661cc62802d2e cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" " ptr 8 8 8 8 in addr arpa\r\n\r\n\  1 c in addr servers arpa 196 216 169 10 ", "uid" null, "command" "ptr", "istransitioned" false, "commandargument" "8 8 8 8", "timerecorded" "2023 11 20t03 43 57 4594957 06 00", "reportingnameserver" "ns3 google com", "timetocomplete" "501", "relatedip" "8 8 8 8", "isendpoint" true, "hassubscriptions" false } } ] soa record lookup lookup soa record endpoint url /lookup/soa/{{search host}}/ method get input argument name type required description search host string required parameter for soa record lookup output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information type string type of the resource domain name string name of the resource primary ns string output field primary ns responsible email string output field responsible email ttl string output field ttl transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned commandargument string output field commandargument timerecorded string output field timerecorded reportingnameserver string name of the resource timetocomplete string output field timetocomplete relatedip object output field relatedip isendpoint boolean output field isendpoint example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "2512", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 45 50 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 322b6bdb76c7cfa0f772f7c1bdfb9198 cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" " soa\ google com\r\n\r\n\  1 l gtld servers net 192 41 162 30 non auth 12 ms ", "uid" null, "command" "soa", "istransitioned" false, "commandargument" "google com", "timerecorded" "2023 11 20t03 45 50 9105476 06 00", "reportingnameserver" "ns4 google com", "timetocomplete" "23", "relatedip" null, "isendpoint" false, "hassubscriptions" false } } ] spf record lookup lookup spf record endpoint url /lookup/spf/{{search host}}/ method get input argument name type required description search host string required parameter for spf record lookup output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information prefix string output field prefix type string type of the resource value string value for the parameter prefixdesc string output field prefixdesc description string output field description recordnum object output field recordnum transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned commandargument string output field commandargument timerecorded string output field timerecorded reportingnameserver string name of the resource timetocomplete string output field timetocomplete relatedip object output field relatedip example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "8763", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 48 39 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 56114c606e1024bc0a2083f7b5516992 cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" " txt\ mxtoolbox com\r\n\r\n\  1 l gtld servers net 192 41 162 30 non auth 32 ", "uid" null, "command" "spf", "istransitioned" false, "commandargument" "mxtoolbox com", "timerecorded" "2023 11 20t03 48 39 2481464 06 00", "reportingnameserver" "ns 1320 awsdns 37 org", "timetocomplete" "316", "relatedip" null, "isendpoint" false, "hassubscriptions" false } } ] txt record lookup lookup txt record endpoint url /lookup/txt/{{search host}}/ method get input argument name type required description search host string required parameter for txt record lookup output parameter type description status code number http status code of the response reason string response reason phrase response object output field response failed array output field failed file name string name of the resource file string output field file passed array output field passed name string name of the resource url string url endpoint for the request information array output field information type string type of the resource domain name string name of the resource ttl string output field ttl record string output field record transcript string output field transcript uid object unique identifier command string output field command istransitioned boolean output field istransitioned commandargument string output field commandargument timerecorded string output field timerecorded reportingnameserver string name of the resource timetocomplete string output field timetocomplete relatedip object output field relatedip isendpoint boolean output field isendpoint hassubscriptions boolean output field hassubscriptions example \[ { "status code" 200, "response headers" { "content type" "application/json; charset=utf 8", "content length" "3499", "connection" "keep alive", "vary" "accept encoding", "date" "mon, 20 nov 2023 09 50 25 gmt", "cache control" "no cache", "pragma" "no cache", "expires" " 1", "server" "microsoft iis/10 0", "x powered by" "urlrewriter net 2 0 0, asp net", "access control allow origin" " ", "x aspnet version" "4 0 30319", "access control allow credentials" "true", "x cache" "miss from cloudfront", "via" "1 1 edf9d353e05a39e52d09ba01bac3000a cloudfront net (cloudfront)" }, "reason" "ok", "response" { "failed" \[], "passed" \[], "information" \[], "transcript" " txt\ mxtoolbox com\r\n\r\n\  1 g gtld servers net 192 42 93 30 non auth 40 ", "uid" null, "command" "txt", "istransitioned" false, "commandargument" "mxtoolbox com", "timerecorded" "2023 11 20t03 50 25 0521531 06 00", "reportingnameserver" "ns 984 awsdns 59 net", "timetocomplete" "51", "relatedip" null, "isendpoint" false, "hassubscriptions" false } } ] response headers header description example access control allow credentials http response header access control allow credentials true access control allow origin http response header access control allow origin cache control directives for caching mechanisms no cache connection http response header connection keep alive content length the length of the response body in bytes 3340 content type the media type of the resource application/json; charset=utf 8 date the date and time at which the message was originated mon, 20 nov 2023 09 45 50 gmt expires the date/time after which the response is considered stale 1 pragma http response header pragma no cache server information about the software used by the origin server microsoft iis/10 0 vary http response header vary accept encoding via http response header via 1 1 56114c606e1024bc0a2083f7b5516992 cloudfront net (cloudfront) x amz cf id http response header x amz cf id dzo51qe wnjfcbjvxa7xd9qonzi1kleoetryuwbrvr5csmldnnrbuw== x amz cf pop http response header x amz cf pop bom78 p8 x aspnet version http response header x aspnet version 4 0 30319 x cache http response header x cache miss from cloudfront x powered by http response header x powered by urlrewriter net 2 0 0, asp net notes mxtoolbox rest api documentation https //mxtoolbox com/user/api/lookup aspx