Sample Responses
Success API Responses If a request succeeds, it will return a status code in the 200 and a JSON.
$ curl -i https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com?type=TXT,AAAA,NS,A,MX
{
"fqdn": "deepinfo.com",
"types_requested": [
"A",
"AAAA",
"MX",
"NS",
"TXT"
],
"types_with_response": [
"A",
"AAAA",
"MX",
"NS",
"TXT"
],
"types_without_response": [],
"types_with_timeout": [],
"responses": [
{
"type": "A",
"raw": "deepinfo.com. 299 IN A 172.67.171.60\ndeepinfo.com. 299 IN A 104.21.29.10",
"values": [
"104.21.29.10",
"172.67.171.60"
],
"server": "8.8.8.8"
},
{
"type": "AAAA",
"raw": "deepinfo.com. 299 IN AAAA 2606:4700:3033::ac43:ab3c\ndeepinfo.com. 299 IN AAAA 2606:4700:3036::6815:1d0a",
"values": [
"2606:4700:3033::ac43:ab3c",
"2606:4700:3036::6815:1d0a"
],
"server": "8.8.8.8"
},
{
"type": "MX",
"raw": "deepinfo.com. 299 IN MX 1 aspmx.l.google.com.\ndeepinfo.com. 299 IN MX 5 alt1.aspmx.l.google.com.\ndeepinfo.com. 299 IN MX 5 alt2.aspmx.l.google.com.\ndeepinfo.com. 299 IN MX 10 alt3.aspmx.l.google.com.\ndeepinfo.com. 299 IN MX 10 alt4.aspmx.l.google.com.",
"values": [
"1 aspmx.l.google.com.",
"5 alt1.aspmx.l.google.com.",
"5 alt2.aspmx.l.google.com.",
"10 alt3.aspmx.l.google.com.",
"10 alt4.aspmx.l.google.com."
],
"server": "8.8.8.8"
},
{
"type": "NS",
"raw": "deepinfo.com. 21599 IN NS may.ns.cloudflare.com.\ndeepinfo.com. 21599 IN NS simon.ns.cloudflare.com.",
"values": [
"may.ns.cloudflare.com.",
"simon.ns.cloudflare.com."
],
"server": "8.8.8.8"
},
{
"type": "TXT",
"raw": "deepinfo.com. 299 IN TXT \"google-site-verification=yruvnCFw5vKluiIoVnufYBNZ-C0HEXArbQN-x14wjmQ\"\ndeepinfo.com. 299 IN TXT \"atlassian-domain-verification=qAThkYEbPZxmRAXdz196YzVLEJxRagOzEAnVLbhUTtRGxyffJcFya4M4rW/Hwl0D\"\ndeepinfo.com. 299 IN TXT \"google-site-verification=EEDz3JvEB7rlbReuBEnQe27ctNNhov-_NwjtbQns3cg\"",
"values": [
"\"atlassian-domain-verification=qAThkYEbPZxmRAXdz196YzVLEJxRagOzEAnVLbhUTtRGxyffJcFya4M4rW/Hwl0D\"",
"\"google-site-verification=EEDz3JvEB7rlbReuBEnQe27ctNNhov-_NwjtbQns3cg\"",
"\"google-site-verification=yruvnCFw5vKluiIoVnufYBNZ-C0HEXArbQN-x14wjmQ\""
],
"server": "8.8.8.8"
}
],
"servers": [
"8.8.8.8"
],
"check_date": "2021-05-17T15:14:31Z"
}
Successful but Empty Response
If FQDN can not be find on the servers, status returns false and response will be empty.
$ curl -i https://api.deepinfo.com/v1/lookup/dns?domain=xn--ehir-45a.xn--ehir-45a.com?type=CNAME
HTTP/1.1 200 OK
...
{
"fqdn": "xn--ehir-45a.xn--ehir-45a.com",
"status": false,
"responses": [],
"servers": [
"8.8.8.8"
],
"check_date": "2021-01-01T11:39:09Z"
}
Successful but “Mismatch“ Response
$ curl -i https://api.deepinfo.com/v1/lookup/dns?domain=www.reddit.com?type=SOA
Normally, the output of the command above is the following:
HTTP/1.1 200 OK
...
{
"fqdn": "www.reddit.com",
"status": true,
"responses": [
{
"type": "SOA",
"records": [
{
"raw": "www.reddit.com. 273 IN CNAME reddit.map.fastly.net.",
"type": "CNAME",
"values": [
"reddit.map.fastly.net."
]
}
],
"status": true,
"server": "8.8.8.8"
}
],
"servers": [
"8.8.8.8"
],
"check_date": "2021-01-01T12:03:22Z"
}
** However, the mismatched ones are ignored. So it behaves as if the response was empty:
HTTP/1.1 200 OK
...
{
"fqdn": "www.reddit.com",
"status": false,
"responses": [],
"servers": [
"8.8.8.8"
],
"check_date": "2021-01-01T12:06:38Z"
}
Updated almost 3 years ago