Asset DNS History Detail

GEThttps://api.deepinfo.com/v1/easm/assets/{asset_id}/dns-history/{history_id}

Returns one DNS snapshot of an asset, by the history_id returned by the list endpoint.

Example

Request

curl

curl 'https://api.deepinfo.com/v1/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001"

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

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

JavaScript

const url = "https://api.deepinfo.com/v1/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001";

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/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001", 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/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001"))
            .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/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001");
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/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001',
    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/easm/assets/000000000000000ea4f90001/dns-history/00000000000000000000000ebd470001')

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

{
  "result": {
    "fqdn": "www.acme.example",
    "requested_types": [
      "A",
      "AAAA"
    ],
    "responses": [
      {
        "type": "A",
        "conn_status": "success",
        "rcode": "NOERROR",
        "raw": "Raw record text.",
        "values": [
          "192.0.2.10",
          "192.0.2.11"
        ],
        "server": "192.0.2.10"
      },
      {
        "type": "AAAA",
        "conn_status": "success",
        "rcode": "NOERROR",
        "raw": "Raw record text.",
        "values": [
          "2001:db8::4",
          "2001:db8::5"
        ],
        "server": "192.0.2.10"
      }
    ],
    "servers": [
      "192.0.2.10"
    ],
    "check_date": "2025-07-31T08:00:00Z"
  },
  "status": true,
  "check_date": "2025-07-31T08:00:00Z"
}

Content-Type: application/json
deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001

Request

curl

curl 'https://api.deepinfo.com/v1/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json'

Python

import requests

url = "https://api.deepinfo.com/v1/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff"

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

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

JavaScript

const url = "https://api.deepinfo.com/v1/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff";

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/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff", 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/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff"))
            .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/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff");
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/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff',
    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/easm/assets/ffffffffffffffffffffffff/dns-history/ffffffffffffffffffffffff')

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

404 Not Found · application/json

Response Body

{
  "code": 30003,
  "details": [
    "Asset does not exist."
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}

Content-Type: application/json
deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001

Authentication

Send your API key in the apikey request header.

Path Parameters

Parameter	Required	Description
`asset_id`	Required	Example`000000000000000ea4f90001`
`history_id`	Required	Example`00000000000000000000000ebd470001`

Response Fields

Field	Type	Description
`result`	object
`status`	boolean
`check_date`	string	date-time

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
`result`	object
`result.fqdn`	string	`"www.acme.example"`
`result.requested_types`	array<string>	`"A"`
`result.responses`	array<object>
`result.responses[].type`	string	`"A"`
`result.responses[].conn_status`	string	`"success"`
`result.responses[].rcode`	string	`"NOERROR"`
`result.responses[].raw`	string	`"Raw record text."`
`result.responses[].values`	array<string>
`result.responses[].server`	string
`result.servers`	array<string>
`result.check_date`	string	`"2025-07-31T08:00:00Z"`
`status`	boolean	`true`
`check_date`	string	`"2025-07-31T08:00:00Z"`

Examples

Selecting one loads it into the request and response panels.

Reference updated September 27, 2026