AuthKey details

  2 minute read  

GET https://www.digicert.com/services/v2/account/auth-key

Use this endpoint to get details about an AuthKey associated with your DigiCert CertCentral® account.

Get the account AuthKey

If the account has exactly one AuthKey, use the following endpoint:

GET https://www.digicert.com/services/v2/account/auth-key

AuthKey details are returned only if a single AuthKey is associated with the account. If multiple AuthKeys exist, a 400 Bad Request error is returned.

Get an AuthKey by ID

To get details for a specific AuthKey, include its unique identifier in the request URL:

GET https://www.digicert.com/services/v2/account/auth-key/{auth_key_id}

You can use the AuthKey ID endpoint to get details for an active, inactive, or expired AuthKey.

Example requests and responses

curl -X GET \
  https://www.digicert.com/services/v2/account/auth-key \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
curl -X GET \
  https://www.digicert.com/services/v2/account/auth-key/{auth_key_id} \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
import requests

auth_key_id = "{{auth_key_id}}"
url = f"https://www.digicert.com/services/v2/account/auth-key/{auth_key_id}"

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

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

print(response.text)
package main

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

func main() {

	authKeyID := "{{auth_key_id}}"
        url := fmt.Sprintf(
	    "https://www.digicert.com/services/v2/account/auth-key/%s",
	    authKeyID,
)

	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/account/auth-key/{{auth_key_id}}',
  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

{
  "auth_key_id": "{{auth_key_id}}",
  "auth_key": "{{auth_key}}",
  "expiration_datetime": "2025-06-06T18:24:09+00:00"
}

Response body

NameTypeDescription
auth_key_idstringID of the created AuthKey.
auth_keystringAuthKey associated with your DigiCert CertCentral® account.
expiration_datetimestringUTC timestamp in ISO 8601 format indicating when the TTL AuthKey expires. Omitted for non-expiring AuthKeys.