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 --request GET 'https://www.digicert.com/services/v2/domain/expiration-count' \
--header 'X-DC-DEVKEY: {{api_key}}'
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)
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))
}
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

NameTypeDescription
number_of_expired_domainsstringNumber of domains with an expired OV or EV domain validation.
number_of_expiry_soon_domainsstringNumber of domains with an OV or EV domain validation that expires in the next 60 days.
number_of_domains_affected_by_mozilla_policystringNumber 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:
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_expiredstringNumber 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_daysstringNumber 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_daysstringNumber 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_daysstringNumber of domains with an OV or EV domain validation that expires in the next 61 (inclusive) to 90 (inclusive) days.