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