Skip to main content

Get order DCV random value

PUT https://www.digicert.com/services/v2/order/certificate/{{order_id}}/dcv-random-value

Use this endpoint to request the domain control validation (DCV) random value for a DV, OV, or EV TLS certificate order using a DCV method of dns-txt-token, dns-cname-token, or http-token.

If a valid order random value already exists, DigiCert returns the existing random value instead of generating a new one. If the existing order random value is expired, DigiCert generates a new random value and returns it in the API response.

Use the order random value to complete the DCV check for any domains submitted for validation with the order.

Example requests and responses

Example 1. cURL
curl -X PUT \
  'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/dcv-random-value' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

Example 2. Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/{{order_id}}/dcv-random-value"

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

response = requests.request("PUT", url, data=payload, 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/order/certificate/{{order_id}}/dcv-random-value"

	req, _ := http.NewRequest("PUT", 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: 'PUT',
  url: 'https://www.digicert.com/services/v2/order/certificate/{{order_id}}/dcv-random-value',
  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

dcv_random_value

string

Random value used to validate domain control.

expiration_date

string

Date and time the random value expires. UTC timezone, ISO 8601 format.

In this section: