---
title: "Get subdomains"
source_url: https://dev.digicert.com/certcentral-apis/discovery-api/subdomains/get-subdomains.html
api_method: POST
api_endpoint: "/apicontroller/v1/scan/getSubdomains"
api_url: "https://daas.digicert.com/apicontroller/v1/scan/getSubdomains"
---

**POST** `https://daas.digicert.com/apicontroller/v1/scan/getSubdomains`

Use this endpoint to get all subdomains included in a scan.

## Related Topic

For more information about scanning subdomains, see <a href="https://docs.digicert.com/en/certcentral/certificate-tools/discovery-user-guide/set-up-and-run-a-scan.html" target="_blank" rel="noopener noreferrer">Set up and run a scan</a>.

## Example requests and responses

## cURL

```bash
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

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

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>accountId</td>
<td>required</td>
<td>string</td>
<td>Account ID.</td>
</tr>
<tr>
<td>Domains</td>
<td>required</td>
<td>array</td>
<td>Domains included in the scan.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>error</td>
<td>object</td>
<td>Includes the error code, if any.</td>
</tr>
<tr>
<td>data</td>
<td>array</td>
<td>List of objects with information about the subdomains found in the scan. This list includes an object for each domain in your request.</td>
</tr>
<tr>
<td>.. count</td>
<td>integer</td>
<td>Total number of subdomains found in the scan for the given domain.</td>
</tr>
<tr>
<td>.. domain</td>
<td>string</td>
<td>Name of the domain.</td>
</tr>
<tr>
<td>.. subdomains</td>
<td>array</td>
<td>List of subdomains found in the scan.</td>
</tr>
</tbody>
</table>