NOTE: this API is only available to Griffin View & Griffin View ASM Edition subscribers with a non-commercial use license. Contact us for details.

WARNING: this process is active as it executes live DNS requests against given domain(s).

ASD Dns Domain Exist APIv1

This API is used to check for the existence of given domain(s). An existing domain is determined using the following ways:

We have passive DNS data found in category:hostname for the last 36 month
Or we launch a DNS brute-force to find existing subdomains (for instance, we try www.DOMAIN.TLD, vpn.DOMAIN.TLD and many more)

If there is a result in one of the previous steps, we consider the domain to exist. Otherwise, it doesn’t in regards to our collecting process. Furthermore, this process is the same we use in Ondemand Scanning APIs for subdomain enumeration, thus, if a domain doesn’t exist trough this API, an Ondemand Scan won’t find anything and would be useless to launch.

Using curl

Call with default parameters:

curl -H 'Content-Type: application/json' -H 'X-Api-Key: YOUR_APIKEY' -XPOST 'https://www.onyphe.io/api/v1/asd/dns/domain/exist' -d '{ "domain":"DOMAIN.TLD" }'

Call against multiple domains and some custom parameters:

curl -H 'Content-Type: application/json' -H 'X-Api-Key: YOUR_APIKEY' -XPOST 'https://www.onyphe.io/api/v1/asd/dns/domain/exist' -d '{ "domain":["DOMAIN1.TLD","DOMAIN2.TLD"],"astask":"false","aslines":"true" }'

Available parameters

domain: one or more domain in array format. Mandatory parameter.
aslines: render results with context information (false) or one JSON per line (true). Default to false.
astask: create a background task for later processing (true). Default to false.

Using ONYPHE CLI

onyphe -asd-dns-domain-exist DOMAIN.TLD
onyphe -asd-dns-domain-exist DOMAIN1.TLD,DOMAIN2.TLD

echo 'domain:"DOMAIN1.TLD"' > /tmp/domain.txt
echo 'domain:"DOMAIN2.TLD"' >> /tmp/domain.txt
onyphe -asd-dns-domain-exist domain.txt

Error codes

error: 0, text: 'success'
error: 1, text: 'internal failure'
error: 2, text: 'request timed out'
error: 3, text: 'connection refused'
error: 4, text: 'unable to fork a new process'
error: 1000, text: 'API not found'
error: 1001, text: 'API access denied'
error: 1002, text: 'parameter error'
error: 1003, text: 'user not found'
error: 1004, text: 'user get failed'
error: 1005, text: 'no more credits'
error: 1006, text: 'search failed'
error: 1007, text: 'task not found'
error: 1008, text: 'creating task failed'
error: 1009, text: 'getting task result failed'
error: 1010, text: 'task in progress'
error: 1011, text: 'too many results, you should create a task'
error: 1012, text: 'unable to kill task'
error: 1013, text: 'resolver failed'