DNS

GEThttps://api.deepinfo.com/v1/lookup/dns

Resolves the current DNS records of a domain or hostname in real time. Request up to five record types in one call. Each request uses one quota unit, whether you ask for one type or five.

Request

curl

curl 'https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/lookup/dns"

params = {
    "domain": "deepinfo.com",
    "type": "A,MX"
}

headers = {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, params=params, headers=headers)
response.raise_for_status()
print(response.json())

JavaScript

const url = "https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "apikey": "YOUR_API_KEY",
    "Accept": "application/json"
  },
});

const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("apikey", "YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	body, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(string(body))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX"))
            .header("apikey", "YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

using System;
using System.Net.Http;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Get, "https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX");
request.Headers.Add("apikey", "YOUR_API_KEY");
request.Headers.Add("Accept", "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'apikey: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($curl);

if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}

echo $response . PHP_EOL;

Ruby

require 'net/http'
require 'uri'

uri = URI('https://api.deepinfo.com/v1/lookup/dns?domain=deepinfo.com&type=A%2CMX')

request = Net::HTTP::Get.new(uri)
request['apikey'] = 'YOUR_API_KEY'
request['Accept'] = 'application/json'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Response

200 OK · application/json

Response Body

{
  "fqdn": "deepinfo.com",
  "requested_types": [
    "A",
    "MX"
  ],
  "responses": [
    {
      "type": "A",
      "conn_status": "success",
      "rcode": "NOERROR",
      "raw": "deepinfo.com. 300 IN A 104.26.11.21\ndeepinfo.com. 300 IN A 104.26.10.21\ndeepinfo.com. 300 IN A 172.67.70.198",
      "values": [
        "104.26.10.21",
        "104.26.11.21",
        "172.67.70.198"
      ],
      "server": "8.8.8.8"
    },
    {
      "type": "MX",
      "conn_status": "success",
      "rcode": "NOERROR",
      "raw": "deepinfo.com. 300 IN MX 10 alt4.aspmx.l.google.com.\ndeepinfo.com. 300 IN MX 5 alt2.aspmx.l.google.com.\ndeepinfo.com. 300 IN MX 10 alt3.aspmx.l.google.com.\ndeepinfo.com. 300 IN MX 5 alt1.aspmx.l.google.com.\ndeepinfo.com. 300 IN MX 1 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"
    }
  ],
  "servers": [
    "8.8.8.8"
  ],
  "check_date": "2026-09-22T12:25:59Z"
}

Content-Type: application/json
deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a

Authentication

Send your API key in the apikey request header.

Query Parameters

Parameter	Required	Description
`domain`	Required	Fully qualified domain name, e.g. `deepinfo.com` or `www.deepinfo.com`. IP addresses are not accepted. Example`deepinfo.com`
`type`	Required	DNS record type names, comma-separated, for example `A,MX`. Up to 5 types per request. Example`A,MX`

Response Fields

Field	Description
`fqdn`	The queried name
`requested_types`	Record types that were requested
`responses[]`	One entry per requested type
`responses[].type`	Record type
`responses[].conn_status`	`success` or `timeout`
`responses[].rcode`	DNS response code, for example `NOERROR` or `NXDOMAIN`
`responses[].values`	Parsed record values
`responses[].raw`	The answer in zone-file format
`responses[].server`	Resolver used
`servers`	Resolvers used for the lookup
`check_date`	When the lookup was performed (UTC)

Response Schema

Inferred from examples Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

Field	Type	Example
`fqdn`	string	`"deepinfo.com"`
`requested_types`	array<string>	`"A"`
`responses`	array<object>
`responses[].type`	string	`"A"`
`responses[].conn_status`	string	`"success"`
`responses[].rcode`	string	`"NOERROR"`
`responses[].raw`	string	`"deepinfo.com. 300 IN A 104.26.11.21…"`
`responses[].values`	array<string>	`"104.26.10.21"`
`responses[].server`	string	`"8.8.8.8"`
`servers`	array<string>	`"8.8.8.8"`
`check_date`	string	`"2026-09-22T12:25:59Z"`

Errors

400 if domain is not a valid FQDN or type is missing.

Examples

The saved example from the Deepinfo API, shown in the request and response panels.

A and MX RecordsGET/lookup/dns?domain=deepinfo.com&type=A,MX200 OK

Worked Examples

Worked examples of this endpoint, each on its own page with the exact request and the response it returns.

A Records of a DomainThe A records of deepinfo.com: the IPv4 addresses the domain points to, in responses[].values.
MX Records: Mail ServersThe MX records of gmail.com: its mail servers with their priorities, lowest (preferred) first.
IPv4 and IPv6 Addresses TogetherA and AAAA of cloudflare.com in one request: one entry per type in responses[].
Five Types at OnceFive record types of deepinfo.com in one request: A, AAAA, MX, NS and TXT, one responses[] entry each.

See all examples

Reference updated September 27, 2026