Download certificate (serial number)

2 minute read

GET https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/ct-cert/{{serial_id}}?issuer={{issuer}}

Use this endpoint to download the certificate’s serial number associated with a CT-logged Secure Site Pro SSL certificate.

This endpoint does not download the certificate itself. This endpoint returns the serial number information of a CT-logged Secure Site Pro SSL certificate. This is the serial number assigned to the certificate on issuance. This endpoint returns serial number only when CT log monitoring is enabled in your CertCentral account. For more information, see Enable CT log monitoring.

Example requests and response

curl -X GET \
  'https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/ct-cert/{{serial_id}}?issuer={{issuer}}' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'

import requests

url = "https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/ct-cert/{{serial_id}}?issuer={{issuer}}"

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

	url := "https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/ct-cert/{{serial_id}}?issuer={{issuer}}"

	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/ctmonitor/{{order_id}}/ct-cert/{{serial_id}}?issuer={{issuer}}',
  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

{
    "pem": "<certificate in pem format>"
}

Request URL query strings

URL query strings are appended to the endpoint URL using a ?.

For example:

https://www.digicert.com/services/v2/ctmonitor/{{order_id}}/ct-cert/{{serial_id}}?issuer={{issuer}}

Name	Req/Opt	Type	Description
order_id	required	integer	ID of the order associated with the certificate event. Example: `1313718630`
serial_id	required	string	Serial number assigned to the certificate on issuance. Example: `2bf1cd8a28fef721f67011d6231c16e` An order can include multiple certificates. Since the serial number is unique to each certificate, both `order_id` and `serial_id` are required to identify the correct certificate.
issuer	required	string	Brand name of the certificate authority that issued the certificate. Examples: RapidSSL Let's Encrypt Sectigo DigiCert Thawte GeoTrust