Use this endpoint to get details for a domain.
To get IDs for the domains in your account, use the List domains endpoint.
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}}'
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)
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))
}
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);
});
{
"id": 76,
"is_active": true,
"status": "approved",
"name": "overtorture-microspectrophotometry.org",
"date_created": "2018-10-15T21:46:29+00:00",
"organization": {
"id": 112233,
"status": "active",
"name": "Palaeontography Enigmatic Corp.",
"assumed_name": "Palaeontography Enigmatic",
"display_name": "Palaeontography Enigmatic Corp. (Palaeontography Enigmatic)",
"is_active": "1"
},
"validations": [
{
"type": "ev",
"name": "EV",
"description": "Extended Organization Validation (EV)",
"date_created": "2018-10-15T21:46:41+00:00",
"validated_until": "2019-11-15T22:46:37+00:00",
"status": "active",
"dcv_status": "complete",
"org_status": "complete",
"verified_users": [
{
"id": 15,
"first_name": "Destinee",
"last_name": "Church",
"email": "destinee.church@outlook.com",
"job_title": "Landscape Architect",
"telephone": "101-656-8415"
}
]
},
{
"type": "ov",
"name": "OV",
"description": "Normal Organization Validation",
"date_created": "2018-10-15T21:46:49+00:00",
"validated_until": "2019-11-15T22:46:49+00:00",
"status": "active",
"dcv_status": "complete",
"org_status": "complete"
}
],
"dcv_method": "email",
"dcv_expiration": {
"ov": "2021-01-01T23:59:59+00:00"
"ev": "2020-01-01T23:59:59+00:00"
},
"container": {
"id": 4,
"parent_id": 0,
"name": "Container Name",
"is_active": true
}
}
Name | Req/Opt | Type | Description |
---|---|---|---|
include_dcv | optional | bool |
Includes DCV info if true .Default: false
|
include_validation | optional | bool |
Includes validation info if true .Default: false
|
Name | Type | Description |
---|---|---|
id | int | Domain ID. |
is_active | bool | Active status of the domain. |
status | string | Validation status of the domain. |
name | string | Name of the domain. |
date_created | string |
Timestamp of when the domain was added. Format: UTC timezone and ISO 8601 date |
organization | object | Organization attached to the domain. |
.. id | int | Organization ID. |
.. status | string | Validation status of the organization. |
.. name | string | Legal name of the organization. |
.. assumed_name | string |
Public name of the organization. Also called DBA name. |
.. display_name | string |
Full name of the organization. Constructed using name + assumed_name. |
.. is_active | string | Active status of the organization. |
validations | array |
List of validation details for the domain. Only returned if URL query include_validation=true .See Structures – Validations object |
dcv_method | string |
Domain control validation method configured for the domain. Only returned if URL query include_validation=true .See Glossary – DCV methods |
dcv_token | object |
If DCV method uses a random value token, this object is returned and contains token information. Only returned if URL query include_validation=true .
|
.. token | string | Random value used to prove control over the domain. |
.. status | string | Status of the domain validation process. |
.. expiration_date | string |
Timestamp of when the token will expire. Format: UTC timezone and ISO 8601 date |
dcv_expiration | object |
If the DCV has been completed, this object is returned and contains information about when the validations expire. Only returned if URL query include_validation=true .
|
.. ov | string |
Timestamp of when validation expires. Format: UTC time zone and ISO 8601 date |
.. ev | string |
Timestamp of when validation expires. Format: UTC time zone and ISO 8601 date |
container | object | Container the domain is attached to. |
.. id | int | Container ID. |
.. parent_id | int | ID of the container's parent. |
.. name | string | Name of the container. |
.. is_active | bool | Active status of the container. |