Mxtoolbox

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 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

Notes

MxToolbox REST API Documentation

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
path_parameters.search_host	string	Required	Host where you want to do the lookups.

Input Example

{"path_parameters":{"search_host":"mxtoolbox.com"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Type	string	Type of the resource
response.Information.Domain Name	string	Name of the resource
response.Information.IP Address	string	Output field: response.Information.IP Address
response.Information.TTL	string	Output field: response.Information.TTL
response.Information.Asn	string	Output field: response.Information.Asn
response.Information.IsIpV6	string	Output field: response.Information.IsIpV6
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned
response.CommandArgument	string	Output field: response.CommandArgument
response.TimeRecorded	string	Output field: response.TimeRecorded
response.ReportingNameServer	string	Name of the resource
response.TimeToComplete	string	Output field: response.TimeToComplete
response.RelatedIP	object	Output field: response.RelatedIP

Output 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 94986b8...

DNS Record Lookup

Endpoint

URL: /lookup/dns/{{search_host}}/

Method: GET

Input

Argument Name	Type	Required	Description
path_parameters.search_host	string	Required	Parameters for the DNS Record Lookup action

Input Example

{"path_parameters":{"search_host":"mxtoolbox.com"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Type	string	Type of the resource
response.Information.Domain Name	string	Name of the resource
response.Information.IP Address	string	Output field: response.Information.IP Address
response.Information.TTL	string	Output field: response.Information.TTL
response.Information.Status	string	Status value
response.Information.Time (ms)	string	Output field: response.Information.Time (ms)
response.Information.Auth	string	Output field: response.Information.Auth
response.Information.Parent	string	Output field: response.Information.Parent
response.Information.Local	string	Output field: response.Information.Local
response.Information.Asn	string	Output field: response.Information.Asn
response.Information.IsIpV6	string	Output field: response.Information.IsIpV6
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned

Output 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 d3e151...

MX Record Lookup

Lookup MX Record.

Endpoint

URL: /lookup/mx/{{search_host}}/

Method: GET

Input

Argument Name	Type	Required	Description
path_parameters.search_host	string	Required	Parameters for the MX Record Lookup action

Input Example

{"path_parameters":{"search_host":"mxtoolbox.com"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Pref	string	Output field: response.Information.Pref
response.Information.Hostname	string	Name of the resource
response.Information.IP Address	string	Output field: response.Information.IP Address
response.Information.TTL	string	Output field: response.Information.TTL
response.Information.Asn	string	Output field: response.Information.Asn
response.Information.IsIpV6	string	Output field: response.Information.IsIpV6
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned
response.CommandArgument	string	Output field: response.CommandArgument
response.TimeRecorded	string	Output field: response.TimeRecorded
response.ReportingNameServer	string	Name of the resource
response.TimeToComplete	string	Output field: response.TimeToComplete
response.RelatedIP	object	Output field: response.RelatedIP

Output 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 a78b605...

PTR Record Lookup

Lookup PTR Record.

Endpoint

URL: /lookup/ptr/{{search_host}}/

Method: GET

Input

Argument Name	Type	Required	Description
path_parameters.search_host	string	Required	Parameters for the PTR Record Lookup action

Input Example

{"path_parameters":{"search_host":"8.8.8.8"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Type	string	Type of the resource
response.Information.IP Address	string	Output field: response.Information.IP Address
response.Information.Domain Name	string	Name of the resource
response.Information.TTL	string	Output field: response.Information.TTL
response.Information.Asn	string	Output field: response.Information.Asn
response.Information.IsIpV6	string	Output field: response.Information.IsIpV6
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned
response.CommandArgument	string	Output field: response.CommandArgument
response.TimeRecorded	string	Output field: response.TimeRecorded
response.ReportingNameServer	string	Name of the resource
response.TimeToComplete	string	Output field: response.TimeToComplete
response.RelatedIP	string	Output field: response.RelatedIP

Output 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 1702d8d...

SOA Record Lookup

Lookup SOA Record.

Endpoint

URL: /lookup/soa/{{search_host}}/

Method: GET

Input

Argument Name	Type	Required	Description
path_parameters.search_host	string	Required	Parameters for the SOA Record Lookup action

Input Example

{"path_parameters":{"search_host":"google.com"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Type	string	Type of the resource
response.Information.Domain Name	string	Name of the resource
response.Information.Primary NS	string	Output field: response.Information.Primary NS
response.Information.Responsible Email	string	Output field: response.Information.Responsible Email
response.Information.TTL	string	Output field: response.Information.TTL
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned
response.CommandArgument	string	Output field: response.CommandArgument
response.TimeRecorded	string	Output field: response.TimeRecorded
response.ReportingNameServer	string	Name of the resource
response.TimeToComplete	string	Output field: response.TimeToComplete
response.RelatedIP	object	Output field: response.RelatedIP
response.IsEndpoint	boolean	Output field: response.IsEndpoint

Output 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 322b6bd...

SPF Record Lookup

Lookup SPF Record.

Endpoint

URL: /lookup/spf/{{search_host}}/

Method: GET

Input

Argument Name	Type	Required	Description
path_parameters.search_host	string	Required	Parameters for the SPF Record Lookup action

Input Example

{"path_parameters":{"search_host":"mxtoolbox.com"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Prefix	string	Output field: response.Information.Prefix
response.Information.Type	string	Type of the resource
response.Information.Value	string	Value for the parameter
response.Information.PrefixDesc	string	Output field: response.Information.PrefixDesc
response.Information.Description	string	Output field: response.Information.Description
response.Information.RecordNum	object	Output field: response.Information.RecordNum
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned
response.CommandArgument	string	Output field: response.CommandArgument
response.TimeRecorded	string	Output field: response.TimeRecorded
response.ReportingNameServer	string	Name of the resource
response.TimeToComplete	string	Output field: response.TimeToComplete
response.RelatedIP	object	Output field: response.RelatedIP

Output 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 56114c6...

TXT Record Lookup

Lookup TXT Record.

Endpoint

URL: /lookup/txt/{{search_host}}/

Method: GET

Input

Argument Name	Type	Required	Description
path_parameters.search_host	string	Required	Parameters for the TXT Record Lookup action

Input Example

{"path_parameters":{"search_host":"mxtoolbox.com"}}

Output

Parameter	Type	Description
status_code	number	HTTP status code of the response
reason	string	Response reason phrase
response	object	Output field: response
response.Failed	array	Output field: response.Failed
response.Failed.file_name	string	Name of the resource
response.Failed.file	string	Output field: response.Failed.file
response.Passed	array	Output field: response.Passed
response.Passed.Name	string	Name of the resource
response.Passed.Url	string	URL endpoint for the request
response.Information	array	Output field: response.Information
response.Information.Type	string	Type of the resource
response.Information.Domain Name	string	Name of the resource
response.Information.TTL	string	Output field: response.Information.TTL
response.Information.Record	string	Output field: response.Information.Record
response.Transcript	string	Output field: response.Transcript
response.UID	object	Unique identifier
response.Command	string	Output field: response.Command
response.IsTransitioned	boolean	Output field: response.IsTransitioned
response.CommandArgument	string	Output field: response.CommandArgument
response.TimeRecorded	string	Output field: response.TimeRecorded
response.ReportingNameServer	string	Name of the resource
response.TimeToComplete	string	Output field: response.TimeToComplete
response.RelatedIP	object	Output field: response.RelatedIP
response.IsEndpoint	boolean	Output field: response.IsEndpoint
response.HasSubscriptions	boolean	Output field: response.HasSubscriptions

Output 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 edf9d35...

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	8763
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:37:21 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 edf9d353e05a39e52d09ba01bac3000a.cloudfront.net (CloudFront)
X-Amz-Cf-Id	HTTP response header: X-Amz-Cf-Id	GNX7z-6HsqJpFd-hFyVrExn_WVU5rWwN91J1OljDtp9mSWTlC6MMtg==
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