CertCentral Services API: Domain management enhancements
To make it easier to maintain active validation for domains in your account, we added new filters, response fields, and a new endpoint to our domain management APIs. With these updates, you can:
- Find domains with OV and EV validation reuse periods that are expired or expiring soon.
- Find domains affected by the September 27, 2021 policy change to shorten OV domain validation reuse periods.*
Enhanced APIs: List domains and List subaccount domains
We made the following enhancements to the List domains and List subaccount domains endpoints:
- Added
validation
filter values
On September 27, 2021*, existing OV domain validation reuse periods will shorten to 397 days from the date validation was completed. For some domains, the reduced validation period will have already expired, or will expire before the end of 2021.
To help you find these domains so you can resubmit them for validation, we added a new value for the validation
filter: shortened_by_industry_changes
. We also added filter values to help you find domains with OV or EV domain validation periods that expire in different timeframes. The new validation
filter values include:shortened_by_industry_changes
ov_expired_in_last_7_days
ov_expiring_within_7_days
ov_expiring_within_30_days
ov_expiring_from_31_to_60_days
ov_expiring_from_61_to_90_days
ev_expired_in_last_7_days
ev_expiring_within_7_days
ev_expiring_within_30_days
ev_expiring_from_31_to_60_days
ev_expiring_from_61_to_90_days
- Added fields to the
dcv_expiration
object
You can now submit a request that returns the following fields in the dcv_expiration
object: ov_shortened
, ov_status
, ev_status
, and dcv_approval_date
. These fields only return if your request includes the newly added query string filters[include_validation_reuse_status]=true
. - Added
dcv_method
filter
We added the option to filter domains by domain control validation (DCV) method. To use this filter, append the query string filters[dcv_method]={{value}}
to the request URL. Possible values are email
, dns-cname-token
, dns-txt-token
, http-token
, and http-token-static
.
Enhanced API: Domain info
You can now submit a request to the Domain info endpoint that returns the following fields in the dcv_expiration
object: ov_shortened
, ov_status
, ev_status
, and dcv_approval_date
. These fields only return if your request includes the newly added query string include_validation_reuse_status=true
.
New API: Expiring domains count
We added a new endpoint that returns the number of domains in your account with expired or expiring OV or EV domain validations. For more information, see Expiring domains count.
*On September 27, 2021, the expiration date for existing OV domain validations will shorten to 397 days from the date validation was completed. Learn more about this policy change: Domain validation changes in 2021.