Skip to main content

Validation details

GET https://www.digicert.com/services/v2/domain/{{domain_id}}/validation

Use this endpoint to get validation details for a domain.

Example requests and responses

Example 1. cURL
curl -X GET \
  'https://www.digicert.com/services/v2/domain/{{domain_id}}/validation' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Example 2. Python
import requests

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

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

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

print(response.text)

Example 3. Go
package main

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

func main() {

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

	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))

}

Example 4. NodeJS
var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/domain/{{domain_id}}/validation',
  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);
});

Response parameters

Name

Type

Description

validations

array

List of validation details for the domain.

.. type

string

Validation type identifier. See Glossary – Validation types.

.. name

string

Name of the validation type.

.. description

string

Description of the validation type.

.. date_created

string

Timestamp of when the domain was validated.

Format: UTC timezone and ISO 8601 date

.. validated_until

string

Timestamp of when the domain validation will expire.

Format: UTC timezone and ISO 8601 date

.. status

string

Status of the validation.

Possible values: pending, active

.. dcv_status

string

Domain control validation status.

.. org_status

string

Organization validation status.

.. verified_users

array

List of users that have been verified for the particular validation type.

.. .. id

int

User ID.

.. .. first_name

string

First name of user.

.. .. last_name

string

Last name of user.

.. .. email

string

Email address of user.

.. .. job_title

string

Job title of user.

.. .. telephone

string

Telephone number of user.

In this section: