Discovered Asset Detail

GEThttps://api.deepinfo.com/v1/easm/discovery/assets/{asset_id}

Returns one discovered asset with the rules and seeds that discovered it.

Example

Request

curl

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

Python

import requests

url = "https://api.deepinfo.com/v1/easm/discovery/assets/00000000000000000000000ea4f90001"

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/discovery/assets/00000000000000000000000ea4f90001";

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/discovery/assets/00000000000000000000000ea4f90001", 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/discovery/assets/00000000000000000000000ea4f90001"))
            .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/discovery/assets/00000000000000000000000ea4f90001");
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/discovery/assets/00000000000000000000000ea4f90001',
    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/discovery/assets/00000000000000000000000ea4f90001')

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

{
  "id": "00000000000000000000000ea4f90001",
  "asset": "acme.example",
  "asset_unicode": "acme.example",
  "asset_type": "domain",
  "state": "in_review",
  "discovery_history": [
    {
      "id": "00000000000000000000000e56420001",
      "rule": "Main domains",
      "rule_type": "smart_discovery",
      "enabled": true,
      "deleted": false,
      "seed_value": "192.0.2.10",
      "description": null,
      "discovery_date": "2025-06-01T08:00:00Z"
    }
  ],
  "last_discovery_date": "2025-06-01T08:00:00Z",
  "monitoring": {
    "whois": null,
    "dns": {
      "fqdn": "acme.example",
      "requested_types": [
        "A",
        "AAAA"
      ],
      "responses": [
        {
          "type": "A",
          "conn_status": "success",
          "rcode": "NOERROR",
          "raw": "Raw record text.",
          "values": [
            "192.0.2.10"
          ],
          "server": "192.0.2.10"
        },
        {
          "type": "AAAA",
          "conn_status": "success",
          "rcode": "NOERROR",
          "raw": null,
          "values": null,
          "server": "192.0.2.10"
        }
      ],
      "servers": [
        "192.0.2.10"
      ],
      "check_date": "2025-07-31T08:00:00Z"
    },
    "ssl": {
      "target": "acme.example",
      "port": 443,
      "check_date": "2025-07-31T08:00:00Z",
      "connection_status": "success",
      "parsed": {
        "version": {
          "name": "v3",
          "value": "18"
        },
        "fingerprint_sha1": "ed8e00abcdef0123456789ed8e00abcdef012345",
        "fingerprint_sha256": "72c800abcdef012345678972c800abcdef012345678972c800abcdef01234567",
        "fingerprint_md5": "41a700abcdef012345678941a700abcd",
        "subject": {
          "dn": "CN=Kestrel Trust CA, O=Kestrel Trust, C=US",
          "common_name": "www.acme.example",
          "country_name": null,
          "locality": null,
          "organization": null,
          "organizational_unit": null,
          "state": null
        },
        "signature": {
          "value": "<data>",
          "self_signed": false,
          "valid": true,
          "valid_chain": true,
          "invalid_reason": null,
          "signature_algorithm": {
            "oid": "1.0.0.0.0.0.0",
            "name": "sha256"
          }
        },
        "validity": {
          "start": "2025-06-01T08:00:00Z",
          "length": 7776000,
          "end": "2026-06-01T08:00:00Z"
        },
        "issuer": {
          "dn": "CN=Kestrel Trust CA, O=Kestrel Trust, C=US",
          "common_name": "Kestrel Trust CA",
          "country_name": "United States",
          "locality": null,
          "organization": "Kestrel Trust",
          "organizational_unit": null,
          "state": null
        },
        "extensions": {
          "key_usage": {
            "digital_signature": true,
            "content_commitment": true,
            "key_agreement": false,
            "data_encipherment": true,
            "key_encipherment": true,
            "key_cert_sign": true,
            "crl_sign": true
          },
          "extended_key_usage": {
            "server_auth": true
          },
          "basic_constraints": {
            "is_ca": false
          },
          "subject_key_identifier": {
            "digest": "<data>"
          },
          "authority_key_identifier": {
            "key_identifier": "<public-key>"
          },
          "authority_info_access": {
            "caissuers_urls": "http://www.fernhill.example/ca.crt"
          },
          "subject_alt_name": {
            "dns_names": [
              "www.acme.example",
              "app.acme.example"
            ]
          },
          "certificate_policies": [
            "1.0.0.0.0.0"
          ],
          "crl_distribution_points": [
            "http://www.fernhill.example/ca.crl"
          ],
          "signed_certificate_timestamp": [
            {
              "log_id": "<data>",
              "timestamp": 1753948800,
              "version": 1,
              "signature": "<signature>"
            },
            {
              "log_id": "<data>",
              "timestamp": 1753344000,
              "version": 1,
              "signature": "<signature>"
            }
          ],
          "other_extensions": []
        },
        "serial_number": "123456789012345678901234567890123456789012",
        "tbs_fingerprint": "e67b00abcdef0123456789e67b00abcdef0123456789e67b00abcdef01234567",
        "subject_key_info": {
          "fingerprint": {
            "hash_algorithm_name": "sha256",
            "value": "848900abcdef0123456789848900abcdef0123456789848900abcdef01234567"
          },
          "key_algorithm": {
            "name": "RSA"
          },
          "rsa_public_key": {
            "length": "2048",
            "modulus": "<public-key>",
            "exponent": "12345"
          }
        },
        "has_expired": false,
        "fqdn_list": [
          "www.acme.example",
          "app.acme.example"
        ]
      },
      "certificate": "<certificate>",
      "parse_errors": []
    },
    "http": {
      "requested_url": "http://acme.example/",
      "version": 1,
      "check_date": "2025-07-31T08:00:00Z",
      "connection_status": "success",
      "requested_domain": "acme.example",
      "final_url": "https://www.acme.example/",
      "final_domain": "acme.example",
      "http": {
        "redirection_history": [
          {
            "url": "http://acme.example/",
            "status_code": 301
          },
          {
            "url": "https://www.acme.example/",
            "status_code": 200
          }
        ],
        "headers": [
          {
            "name": "content-type",
            "value": "text/html; charset=utf-8"
          },
          {
            "name": "cache-control",
            "value": "<value>"
          }
        ],
        "cookies": []
      },
      "html": {
        "source_hash_code": "c61800abcdef0123456789c61800abcdef0123456789c61800abcdef01234567"
      },
      "final_status_code": 200
    },
    "ipwhois": null,
    "ipdns": null
  },
  "approve_date": null,
  "ignore_date": null
}

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

Request

curl

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

Python

import requests

url = "https://api.deepinfo.com/v1/easm/discovery/assets/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/discovery/assets/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/discovery/assets/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/discovery/assets/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/discovery/assets/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/discovery/assets/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/discovery/assets/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": [
    "Discovered 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`00000000000000000000000ea4f90001`

Response Fields

Field	Type	Description
`id`	string
`asset`	string
`asset_unicode`	string
`asset_type`	string	One of `domain`, `subdomain`, `ip`, `website`
`state`	string	One of `in_review`, `approved`, `ignored`
`discovery_history`	array of object
`last_discovery_date`	string	date-time
`monitoring`	object
`approve_date`	string	date-time
`ignore_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
`id`	string	`"00000000000000000000000ea4f90001"`
`asset`	string	`"acme.example"`
`asset_unicode`	string	`"acme.example"`
`asset_type`	string	`"domain"`
`state`	string	`"in_review"`
`discovery_history`	array<object>
`discovery_history[].id`	string	`"00000000000000000000000e56420001"`
`discovery_history[].rule`	string	`"Main domains"`
`discovery_history[].rule_type`	string	`"smart_discovery"`
`discovery_history[].enabled`	boolean	`true`
`discovery_history[].deleted`	boolean	`false`
`discovery_history[].seed_value`	string
`discovery_history[].description`	null
`discovery_history[].discovery_date`	string	`"2025-06-01T08:00:00Z"`
`last_discovery_date`	string	`"2025-06-01T08:00:00Z"`
`monitoring`	object
`monitoring.whois`	null
`monitoring.dns`	object
`monitoring.dns.fqdn`	string	`"acme.example"`
`monitoring.dns.requested_types`	array<string>	`"A"`
`monitoring.dns.responses`	array<object>
`monitoring.dns.responses[].type`	string	`"A"`
`monitoring.dns.responses[].conn_status`	string	`"success"`
`monitoring.dns.responses[].rcode`	string	`"NOERROR"`
`monitoring.dns.responses[].raw`	string \| null	`"Raw record text."`
`monitoring.dns.responses[].values`	array<string> \| null
`monitoring.dns.responses[].server`	string
`monitoring.dns.servers`	array<string>
`monitoring.dns.check_date`	string	`"2025-07-31T08:00:00Z"`
`monitoring.ssl`	object
`monitoring.ssl.target`	string	`"acme.example"`
`monitoring.ssl.port`	number	`443`
`monitoring.ssl.check_date`	string	`"2025-07-31T08:00:00Z"`
`monitoring.ssl.connection_status`	string	`"success"`
`monitoring.ssl.parsed`	object
`monitoring.ssl.parsed.version`	object
`monitoring.ssl.parsed.version.name`	string	`"v3"`
`monitoring.ssl.parsed.version.value`	string	`"18"`
`monitoring.ssl.parsed.fingerprint_sha1`	string
`monitoring.ssl.parsed.fingerprint_sha256`	string
`monitoring.ssl.parsed.fingerprint_md5`	string
`monitoring.ssl.parsed.subject`	object
`monitoring.ssl.parsed.subject.dn`	string	`"CN=Kestrel Trust CA, O=Kestrel Trus…"`
`monitoring.ssl.parsed.subject.common_name`	string	`"www.acme.example"`
`monitoring.ssl.parsed.subject.country_name`	null
`monitoring.ssl.parsed.subject.locality`	null
`monitoring.ssl.parsed.subject.organization`	null
`monitoring.ssl.parsed.subject.organizational_unit`	null
`monitoring.ssl.parsed.subject.state`	null
`monitoring.ssl.parsed.signature`	object
`monitoring.ssl.parsed.signature.value`	string
`monitoring.ssl.parsed.signature.self_signed`	boolean	`false`
`monitoring.ssl.parsed.signature.valid`	boolean	`true`
`monitoring.ssl.parsed.signature.valid_chain`	boolean	`true`
`monitoring.ssl.parsed.signature.invalid_reason`	null
`monitoring.ssl.parsed.signature.signature_algorithm`	object
`monitoring.ssl.parsed.signature.signature_algorithm.oid`	string	`"1.0.0.0.0.0.0"`
`monitoring.ssl.parsed.signature.signature_algorithm.name`	string	`"sha256"`
`monitoring.ssl.parsed.validity`	object
`monitoring.ssl.parsed.validity.start`	string	`"2025-06-01T08:00:00Z"`
`monitoring.ssl.parsed.validity.length`	number	`7776000`
`monitoring.ssl.parsed.validity.end`	string	`"2026-06-01T08:00:00Z"`
`monitoring.ssl.parsed.issuer`	object
`monitoring.ssl.parsed.issuer.dn`	string	`"CN=Kestrel Trust CA, O=Kestrel Trus…"`
`monitoring.ssl.parsed.issuer.common_name`	string	`"Kestrel Trust CA"`
`monitoring.ssl.parsed.issuer.country_name`	string	`"United States"`
`monitoring.ssl.parsed.issuer.locality`	null
`monitoring.ssl.parsed.issuer.organization`	string	`"Kestrel Trust"`
`monitoring.ssl.parsed.issuer.organizational_unit`	null
`monitoring.ssl.parsed.issuer.state`	null
`monitoring.ssl.parsed.extensions`	object
`monitoring.ssl.parsed.extensions.key_usage`	object
`monitoring.ssl.parsed.extensions.key_usage.digital_signature`	boolean	`true`
`monitoring.ssl.parsed.extensions.key_usage.content_commitment`	boolean	`true`
`monitoring.ssl.parsed.extensions.key_usage.key_agreement`	boolean	`false`
`monitoring.ssl.parsed.extensions.key_usage.data_encipherment`	boolean	`true`
`monitoring.ssl.parsed.extensions.key_usage.key_encipherment`	boolean	`true`
`monitoring.ssl.parsed.extensions.key_usage.key_cert_sign`	boolean	`true`
`monitoring.ssl.parsed.extensions.key_usage.crl_sign`	boolean	`true`
`monitoring.ssl.parsed.extensions.extended_key_usage`	object
`monitoring.ssl.parsed.extensions.extended_key_usage.server_auth`	boolean	`true`
`monitoring.ssl.parsed.extensions.basic_constraints`	object
`monitoring.ssl.parsed.extensions.basic_constraints.is_ca`	boolean	`false`
`monitoring.ssl.parsed.extensions.subject_key_identifier`	object
`monitoring.ssl.parsed.extensions.subject_key_identifier.digest`	string
`monitoring.ssl.parsed.extensions.authority_key_identifier`	object
`monitoring.ssl.parsed.extensions.authority_key_identifier.key_identifier`	string
`monitoring.ssl.parsed.extensions.authority_info_access`	object
`monitoring.ssl.parsed.extensions.authority_info_access.caissuers_urls`	string	`"http://www.fernhill.example/ca.crt"`
`monitoring.ssl.parsed.extensions.subject_alt_name`	object
`monitoring.ssl.parsed.extensions.subject_alt_name.dns_names`	array<string>	`"www.acme.example"`
`monitoring.ssl.parsed.extensions.certificate_policies`	array<string>	`"1.0.0.0.0.0"`
`monitoring.ssl.parsed.extensions.crl_distribution_points`	array<string>	`"http://www.fernhill.example/ca.crl"`
`monitoring.ssl.parsed.extensions.signed_certificate_timestamp`	array<object>
`monitoring.ssl.parsed.extensions.signed_certificate_timestamp[].log_id`	string	`"<data>"`
`monitoring.ssl.parsed.extensions.signed_certificate_timestamp[].timestamp`	number	`1753948800`
`monitoring.ssl.parsed.extensions.signed_certificate_timestamp[].version`	number	`1`
`monitoring.ssl.parsed.extensions.signed_certificate_timestamp[].signature`	string
`monitoring.ssl.parsed.extensions.other_extensions`	array
`monitoring.ssl.parsed.serial_number`	string
`monitoring.ssl.parsed.tbs_fingerprint`	string
`monitoring.ssl.parsed.subject_key_info`	object
`monitoring.ssl.parsed.subject_key_info.fingerprint`	object
`monitoring.ssl.parsed.subject_key_info.fingerprint.hash_algorithm_name`	string	`"sha256"`
`monitoring.ssl.parsed.subject_key_info.fingerprint.value`	string
`monitoring.ssl.parsed.subject_key_info.key_algorithm`	object
`monitoring.ssl.parsed.subject_key_info.key_algorithm.name`	string	`"RSA"`
`monitoring.ssl.parsed.subject_key_info.rsa_public_key`	object
`monitoring.ssl.parsed.subject_key_info.rsa_public_key.length`	string	`"2048"`
`monitoring.ssl.parsed.subject_key_info.rsa_public_key.modulus`	string
`monitoring.ssl.parsed.subject_key_info.rsa_public_key.exponent`	string	`"12345"`
`monitoring.ssl.parsed.has_expired`	boolean	`false`
`monitoring.ssl.parsed.fqdn_list`	array<string>	`"www.acme.example"`
`monitoring.ssl.certificate`	string	`"<certificate>"`
`monitoring.ssl.parse_errors`	array
`monitoring.http`	object
`monitoring.http.requested_url`	string	`"http://acme.example/"`
`monitoring.http.version`	number	`1`
`monitoring.http.check_date`	string	`"2025-07-31T08:00:00Z"`
`monitoring.http.connection_status`	string	`"success"`
`monitoring.http.requested_domain`	string	`"acme.example"`
`monitoring.http.final_url`	string	`"https://www.acme.example/"`
`monitoring.http.final_domain`	string	`"acme.example"`
`monitoring.http.http`	object
`monitoring.http.http.redirection_history`	array<object>
`monitoring.http.http.redirection_history[].url`	string	`"http://acme.example/"`
`monitoring.http.http.redirection_history[].status_code`	number	`301`
`monitoring.http.http.headers`	array<object>
`monitoring.http.http.headers[].name`	string	`"content-type"`
`monitoring.http.http.headers[].value`	string	`"text/html; charset=utf-8"`
`monitoring.http.http.cookies`	array
`monitoring.http.html`	object
`monitoring.http.html.source_hash_code`	string
`monitoring.http.final_status_code`	number	`200`
`monitoring.ipwhois`	null
`monitoring.ipdns`	null
`approve_date`	null
`ignore_date`	null

Examples

Selecting one loads it into the request and response panels.

Reference updated September 27, 2026