Get subdomains

  less than a minute  

POST https://daas.digicert.com/apicontroller/v1/scan/getSubdomains
Use this endpoint to get all subdomains included in a scan.

For more information about scanning subdomains, see Set up and run a scan.

Example requests and responses

cURL

curl --location --request POST 'https://daas.digicert.com/apicontroller/v1/scan/getSubdomains' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw 
'{
	"accountId": 5153184,
	"domains": ["www.yahoo.com"]
}'

200 OK

{
    "error": null,
    "data": [{
		"count": 2,
		"domain": "www.yahoo.com",
		"subdomains": ["accountlink.www.yahoo.com", "secure.www.yahoo.com"]
	}]
}

Request parameters

NameReq/OptTypeDescription
accountIdrequiredstringAccount ID.
DomainsrequiredarrayDomains included in the scan.

Response parameters

NameTypeDescription
errorobjectIncludes the error code, if any.
dataarrayList of objects with information about the subdomains found in the scan. This list includes an object for each domain in your request.
.. countintegerTotal number of subdomains found in the scan for the given domain.
.. domainstringName of the domain.
.. subdomainsarrayList of subdomains found in the scan.