Expiring domains count

GET
https://www.digicert.com/services/v2/domain/expiration-count

Use this endpoint to get the number of domains in your account with expired or expiring OV or EV domain validations.

Example requests and responses

cURL
curl --request GET 'https://www.digicert.com/services/v2/domain/expiration-count' \
--header 'X-DC-DEVKEY: {{api_key}}'
Python
import requests
import json

url = "https://www.digicert.com/services/v2/domain/expiration-count"

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

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

print(response.text)
Go
package main

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

func main() {

		url := "https://www.digicert.com/services/v2/domain/expiration-count"
		method := "GET"

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, nil)

		if err != nil {
				fmt.Println(err)
				return
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		req.Header.Add("Content-Type", "application/json")

		res, err := client.Do(req)
		if err != nil {
				fmt.Println(err)
				return
		}
		defer res.Body.Close()

		body, err := ioutil.ReadAll(res.Body)
		if err != nil {
				fmt.Println(err)
				return
		}
		fmt.Println(string(body))
}
NodeJS
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://www.digicert.com/services/v2/domain/expiration-count',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'application/json'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
200 OK
{
  "number_of_expired_domains": "909",
  "number_of_expiry_soon_domains": "99",
  "number_of_domains_affected_by_mozilla_policy": "379",
  "number_of_domains_recent_expired": "10",
  "number_of_domains_expiring_within_30_days": "60",
  "number_of_domains_expiring_from_31_to_60_days": "77",
  "number_of_domains_expiring_from_61_to_90_days": "85"
}

Response parameters

Name Type Description
number_of_expired_domains integer Number of domains with an expired OV or EV domain validation.
number_of_expiry_soon_domains integer Number of domains with an OV or EV domain validation that expires in the next 60 days.
number_of_domains_affected_by_mozilla_policy integer Number of domains with an OV validation that will be affected by the September 27, 2021 policy change to shorten the OV domain validation reuse period to 397 days.

This count includes:
  • Domains with OV validation that will shorten to become expired.
  • Domains with OV validation that will shorten to expire before December 1, 2021.
After September 27, this parameter will always return 0.

Note: On September 27, 2021, DigiCert shortens the domain validation reuse period for OV certificates to 397 days. Learn more about this policy change: Domain validation changes in 2021.
number_of_domains_recent_expired integer Number of domains with an OV or EV domain validation that expired between 7 days ago (inclusive) and today (exclusive).
number_of_domains_expiring_within_30_days integer Number of domains with an OV or EV domain validation that expires in the next 0 (inclusive) to 30 (inclusive) days.
number_of_domains_expiring_from_31_to_60_days integer Number of domains with an OV or EV domain validation that expires in the next 31 (inclusive) to 60 (inclusive) days.
number_of_domains_expiring_from_61_to_90_days integer Number of domains with an OV or EV domain validation that expires in the next 61 (inclusive) to 90 (inclusive) days.