---
title: "Domain info"
source_url: https://dev.digicert.com/certcentral-apis/services-api/domains/domain-info.html
api_method: GET
api_endpoint: "/services/v2/domain/{{domain_id}}"
api_url: "https://www.digicert.com/services/v2/domain/{{domain_id}}?include_dcv=true&include_validation=true"
---

**GET** `https://www.digicert.com/services/v2/domain/{{domain_id}}?include_dcv=true&include_validation=true`

Use this endpoint to get details for a domain.

To get IDs for the domains in your account, use the [List domains](https://dev.digicert.com/md/certcentral-apis/services-api/domains/list-domains.md) endpoint.

## Example requests and responses

**cURL**

```bash
curl -X GET \
  'https://www.digicert.com/services/v2/domain/{{domain_id}}?include_dcv=true&include_validation=true' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
```

**Python**

```python
import requests

url = "https://www.digicert.com/services/v2/domain/{{domain_id}}"

querystring = {"include_dcv":"true","include_validation":"true"}

headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)
```

**Go**

```go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/domain/{{domain_id}}?include_dcv=true&include_validation=true"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

**NodeJS**

```javascript
var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/domain/{{domain_id}}',
  qs: { include_dcv: 'true', include_validation: 'true' },
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
```


## 200 OK

```json
{
  "id": 12345678,
  "is_active": true,
  "status": "pending",
  "is_pending_validation": true,
  "name": "example.com",
  "date_created": "2021-04-27T14:49:28+00:00",
  "dcv_approval_datetime": "2021-05-27T22:11:22+00:00",
  "dcv_expiration_datetime": "2022-05-27T22:11:22+00:00",
  "organization": {
    "id": 12345678,
    "status": "active",
    "name": "Example Corp.",
    "display_name": "Example Corp.",
    "is_active": "1"
  },
  "validations": [
    {
      "type": "ov",
      "name": "OV",
      "description": "Normal Organization Validation",
      "validated_until": "2022-05-27T14:51:31+00:00",
      "status": "active",
      "dcv_status": "complete"
    },
    {
      "type": "ev",
      "name": "EV",
      "description": "Extended Organization Validation (EV)",
      "validated_until": "2022-05-27T14:51:31+00:00",
      "status": "active",
      "dcv_status": "complete"
    }
  ],
  "dcv_method": "dns-txt-token",
  "dcv_token": {
    "token": {{dcv_token}},
    "status": "active",
    "expiration_date": "2022-02-24T16:25:52+00:00"
  },
  "dcv_expiration": {
    "ev": "2022-05-27",
    "ov": "2022-05-27"
  },
  "container": {
    "id": 123456,
    "name": "Example Corp."
  },
  "base_domain": "example.com",
  "dcv__approval_method": "dns-txt-token"
}
```

## Path parameters

<table>
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>domain_id</td>
<td>required</td>
<td>ID of the domain to query.</td>
</tr>
</tbody>
</table>

## URL query strings

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>include_dcv</td>
<td>optional</td>
<td>boolean</td>
<td>If <code>true</code>, returns domain control validation (DCV) details in the response.<br>Default:
false</td>
</tr>
<tr>
<td>include_validation</td>
<td>optional</td>
<td>boolean</td>
<td>If <code>true</code>, returns validation details in the response. Validation details are returned in the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/domains/domain-info.md#validations">validations</a> array.<br>Default:
false</td>
</tr>
<tr>
<td>include_validation_reuse_status</td>
<td>optional</td>
<td>boolean</td>
<td>If <code>true</code>, the <code>dcv_expiration</code> object in the response includes <code>ov_shortened</code>, <code>ov_status</code>, <code>ev_status</code>, and <code>dcv_approval_date</code> response parameters.<br>Default:
false</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>id</td>
<td>integer</td>
<td>Domain ID.</td>
</tr>
<tr>
<td>is_active</td>
<td>boolean</td>
<td>Active status of the domain.</td>
</tr>
<tr>
<td>status<br><strong>Deprecated</strong><sup>*</sup></td>
<td>string</td>
<td>Validation status of the domain.<br><strong>*Note:</strong> DigiCert has deprecated the <code>status</code> response parameter.<br><ul><li>In integrations that use <strong>Domain info</strong> response data, you can safely remove or ignore the value of the <code>status</code> parameter.</li><li>To get a more comprehensive validation status for your domains, include the query parameter <a href="https://dev.digicert.com/md/certcentral-apis/services-api/domains/domain-info.md#include_validation">include_validation=true</a> when you submit your request. The <a href="https://dev.digicert.com/md/certcentral-apis/services-api/domains/domain-info.md#validations">validations</a> array returns the status for each type of validation on the domain.</li></ul></td>
</tr>
<tr>
<td>is_pending_validation</td>
<td>boolean</td>
<td>Pending status of the domain.</td>
</tr>
<tr>
<td>name</td>
<td>string</td>
<td>Name of the domain.</td>
</tr>
<tr>
<td>date_created</td>
<td>string</td>
<td>Timestamp of when the domain was added.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>domain_locking_status</td>
<td>string</td>
<td>Domain lock status. Domain locking prevents users in other CertCentral accounts from requesting certificates for the domain.<br>A domain only returns the <code>domain_locking_status</code> property if domain locking is enabled for the account. See <a href="https://docs.digicert.com/en/certcentral/manage-certificates/organization-and-domain-management/domain-locking.html#enable-domain-locking-for-your-account" target="_blank" rel="noopener noreferrer">Domain locking – Enable domain locking for your account</a>.<br><strong>Possible values:</strong><br><ul><li><code>disabled</code>: Domain lock disabled. Users in other CertCentral accounts can request certificates for the domain.</li><li><code>pending</code>: Domain lock pending. To finish setting up domain locking, place the account token (<code>account_token</code>) on the DNS Certificate Authority Authorization (CAA) resource record for the domain (see <a href="https://docs.digicert.com/en/certcentral/manage-certificates/organization-and-domain-management/domain-locking.html#locking-a-domain" target="_blank" rel="noopener noreferrer">Domain locking – Locking a domain</a>, step 6). Then, submit a request to the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/domains/check-caa-domain-lock.md">Check CAA (domain lock)</a> endpoint.</li><li><code>enabled</code>: Domain lock enabled. Only users belonging to your CertCentral account can request certificates for the domain.</li></ul></td>
</tr>
<tr>
<td>account_token</td>
<td>string</td>
<td>Account token to use for domain locking.<br>A domain only returns the <code>account_token</code> parameter if these conditions are met:<br><ul><li>Domain locking is enabled for the account. See <a href="https://docs.digicert.com/en/certcentral/manage-certificates/organization-and-domain-management/domain-locking.html#enable-domain-locking-for-your-account" target="_blank" rel="noopener noreferrer">Domain locking – Enable domain locking for your account</a>.</li><li>Domain locking has been activated for the domain at least once. If domain locking has never been activated, no token exists for the domain, and the domain object does not include an <code>account_token</code> parameter.</li></ul></td>
</tr>
<tr>
<td>dcv_approval_datetime</td>
<td>string</td>
<td>Completion date and time (UTC) of the most recent DCV check for the domain. Only returned if request URL contains <code>include_dcv=true</code> and you have completed a DCV check for the domain at least once.<br><strong>Format:</strong> UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>dcv_expiration_datetime</td>
<td>string</td>
<td>Expiration date and time (UTC) of the most recent DCV check for the domain. Only returned if request URL contains <code>include_dcv=true</code> and you have completed a DCV check for the domain at least once.<br><strong>Format:</strong> UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>organization</td>
<td>object</td>
<td>Organization attached to the domain.</td>
</tr>
<tr>
<td>.. id</td>
<td>integer</td>
<td>Organization ID.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Organization status.<br>Possible values:active, inactive. For more information, see Glossary - Organization status.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Legal name of the organization.</td>
</tr>
<tr>
<td>.. assumed_name</td>
<td>string</td>
<td>Public name of the organization. Also called DBA name.</td>
</tr>
<tr>
<td>.. display_name</td>
<td>string</td>
<td>Full name of the organization. Constructed using name + assumed_name.</td>
</tr>
<tr>
<td>.. is_active</td>
<td>string</td>
<td>Active status of the organization.</td>
</tr>
<tr>
<td>validations</td>
<td>array</td>
<td>List of objects with details about each type of validation on the domain. Only returned if request URL contains <code>include_validation=true</code>.<br>For information about the data structure and key/value pairs for objects returned in the <code>validations</code> array, see <a href="https://dev.digicert.com/md/certcentral-apis/services-api/structures.md#validations-object">Structures – Validations object</a>.</td>
</tr>
<tr>
<td>.. type</td>
<td>string</td>
<td>Type of validation.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Name of validation.</td>
</tr>
<tr>
<td>.. description</td>
<td>string</td>
<td>Description of validation.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Status of validation.</td>
</tr>
<tr>
<td>.. dcv_status</td>
<td>string</td>
<td>DCV status of validation.</td>
</tr>
<tr>
<td>dcv_method</td>
<td>string</td>
<td>Latest DCV method configured for the domain. Only returned if request URL contains <code>include_dcv=true</code>.<br><strong>Possible values:</strong> See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#dcv-methods">Glossary – DCV methods</a></td>
</tr>
<tr>
<td>dcv_token</td>
<td>object</td>
<td>If DCV method uses a random value, this object is returned and contains token information. Only returned if request URL contains include_dcv=true.</td>
</tr>
<tr>
<td>.. token</td>
<td>string</td>
<td>Random value used to complete DCV. For DNS CNAME validation, this value is used to construct the CNAME record target.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Status of the domain validation process.</td>
</tr>
<tr>
<td>.. expiration_date</td>
<td>string</td>
<td>Timestamp of when the token will expire.<br>Format: UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>higher_level_domains</td>
<td>array of objects</td>
<td>List of existing higher-level domains with a complete domain control validation (DCV) check for the same organization as the queried domain. If none exist, the response omits the <code>higher_level_domains</code> array.<br>Use the <code>higher_level_domains</code> list to see if there are any domains in your account with active validations you can reuse to prove control over the queried domain. When you complete DCV for a higher-level domain, you prove you control any subdomains of the validated domain. You can request an OV or EV TLS certificate for those subdomains without completing a new DCV check.<br><strong>Note:</strong> The response only includes the <code>higher_level_domains</code> array if the request URL includes the query string <code>include_dcv=true</code>.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Domain name (FQDN) of the higher-level domain.</td>
</tr>
<tr>
<td>.. id</td>
<td>integer</td>
<td>Domain ID of the higher-level domain.</td>
</tr>
<tr>
<td>.. dcv_expiration_datetime</td>
<td>string</td>
<td>Expiration date and time (UTC) of the most recent DCV check for the higher-level domain.<br><strong>Format:</strong> UTC timezone and ISO 8601 date</td>
</tr>
<tr>
<td>dcv_expiration</td>
<td>string</td>
<td>If DCV is completed, this object is returned with information about when OV and EV domain validations expire. Only returned if request URL contains <code>include_dcv=true</code>.</td>
</tr>
<tr>
<td>.. ev</td>
<td>string</td>
<td>Expiration date for EV domain validation.<br>Format:
YYYY-MM-DD</td>
</tr>
<tr>
<td>.. ov</td>
<td>string</td>
<td>Expiration date for OV domain validation.<br>Format:
YYYY-MM-DD<br>Note: On September 27, 2021, the expiration date for existing OV domain validations will shorten to 397 days from the date validation was completed. Learn more about this policy change: Domain validation changes in 2021.</td>
</tr>
<tr>
<td>.. ov_shortened</td>
<td>string</td>
<td>New expiration date for OV domain validation after industry changes to shorten the domain validation reuse period go into effect on September 27, 2021. Only returned if request URL contains <code>include_validation_reuse_status=true</code>.<br>Format:
YYYY-MM-DD<br>Note: After September 27, 2021, the dcv_expiration.ov_shortened parameter will return the same date as the dcv_expiration.ov parameter. Learn more about this policy change: Domain validation changes in 2021.</td>
</tr>
<tr>
<td>.. ov_status</td>
<td>string</td>
<td>OV domain validation status. Only returned if request URL contains <code>include_validation_reuse_status=true</code>.<br>Possible values:<br><ul><li>expired: OV domain validation is expired.</li><li>expiring_soon: OV domain validation expires in the next 60 days.</li><li>valid: OV domain validation is valid.</li><li>industry_shortened_expired: On September 27, 2021, OV domain validation will be reduced. The reduced validation period will be expired.</li><li>industry_shortened_expiring_soon: On September 27, 2021, OV domain validation will be reduced. The reduced validation period will expire before December 1, 2021.</li></ul><br>Note: After September 27, 2021, the ov_status parameter stopped returning industry_shortened_expired and industry_shortened_expiring_soon values. Learn more about this policy change: Domain validation changes in 2021.</td>
</tr>
<tr>
<td>.. ev_status</td>
<td>string</td>
<td>EV domain validation status.<br>Possible values:<br><ul><li>expired: EV domain validation is expired.</li><li>expiring_soon: EV domain validation expires in the next 60 days.</li><li>valid: EV domain validation is valid.</li></ul></td>
</tr>
<tr>
<td>.. dcv_approval_date</td>
<td>string</td>
<td>Date of the most recent DCV approval for the domain. Only returned if request URL contains <code>include_validation_reuse_status=true</code>.<br>Format:
YYYY-MM-DD</td>
</tr>
<tr>
<td>container</td>
<td>object</td>
<td>Container the domain is attached to.</td>
</tr>
<tr>
<td>.. id</td>
<td>int</td>
<td>Container ID.</td>
</tr>
<tr>
<td>.. parent_id</td>
<td>int</td>
<td>ID of the container's parent.</td>
</tr>
<tr>
<td>.. name</td>
<td>string</td>
<td>Name of the container.</td>
</tr>
<tr>
<td>.. is_active</td>
<td>bool</td>
<td>Active status of the container.</td>
</tr>
<tr>
<td>base_domain</td>
<td>string</td>
<td>Base domain of the domain.</td>
</tr>
<tr>
<td>dcv_approval_method</td>
<td>string</td>
<td>DCV method used to complete the most recent DCV check. Only returned if request URL contains <code>include_dcv=true</code>.<br><strong>Possible values:</strong> See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md#dcv-methods">Glossary – DCV methods</a></td>
</tr>
</tbody>
</table>