List replacement benefits

POST
https://www.digicert.com/services/v2/competitive-replacement/certificates

Use this endpoint to get information about the discounts available when replacing the certificates on one or more of your domains with a DigiCert product.

To use this endpoint, competitive replacement must be enabled and configured for your account. Contact your account manager or our support team to have this feature enabled.

Example requests and response

cURL 
curl -X POST 'https://www.digicert.com/services/v2/competitive-replacement/certificates' \
-H 'Content-Type: application/json' \
-H 'X-DC-DEVKEY: {{api_key}}' \
-d '{
	"domains": ["exampledomain1.com", "exampledomain2.com"]
}'
Python 
import requests

url = "https://www.digicert.com/services/v2/competitive-replacement/certificates"

payload = "{\n\t\"domains\": [\"exampledomain1.com\", \"exampledomain2.com\"]\n}"
headers = {
  'Content-Type': 'application/json',
  'X-DC-DEVKEY': '{{api_key}}'
}

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

print(response.text.encode('utf8'))
Go 
package main

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

func main() {

  url := "https://www.digicert.com/services/v2/competitive-replacement/certificates"
  method := "POST"

  payload := strings.NewReader("{\n	\"domains\": [\"exampledomain1.com\", \"exampledomain2.com\"]\n}")

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

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

  res, err := client.Do(req)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)

  fmt.Println(string(body))
}
NodeJS 
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://www.digicert.com/services/v2/competitive-replacement/certificates',
  'headers': {
    'Content-Type': 'application/json',
    'X-DC-DEVKEY': '{{api_key}}'
  },
  body: JSON.stringify({"domains":["exampledomain1.com","exampledomain2.com"]})

};
request(options, function (error, response) { 
  if (error) throw new Error(error);
  console.log(response.body);
});
200 OK 
{
    "certificates": [
        {
            "subject": "exampledomain1.com",
            "san_list": [
                "exampledomain1.com"
            ],
            "serial_number": "{{certificate_serial_number}}",
            "issuer_ca": "Network Solutions OV Server CA 2",
            "issuer_brand": "Sectigo",
            "not_before": "2020-03-16T00:00:00.000+0000",
            "not_after": "2020-06-14T23:59:59.000+0000",
            "validation_type": "OV",
            "matched_domains_count": 1,
            "matched_domains": [
                "exampledomain1.com"
            ],
            "certificate_replacement_benefits": [
                {
                    "to_product_type": "EV",
                    "bonus_type": "DISCOUNT",
                    "bonus_unit": 15,
                    "products": [
                        {
                            "product_name_id": "ssl_ev_basic",
                            "product_name": "Basic EV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_ev_geotrust_truebizid",
                            "product_name": "GeoTrust TrueBusiness ID EV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_ev_securesite_flex",
                            "product_name": "Secure Site EV",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_ev_securesite_pro",
                            "product_name": "Secure Site Pro EV SSL",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_ev_thawte_webserver",
                            "product_name": "Thawte SSL Webserver EV",
                            "additional_discount": 0
                        }
                    ]
                },
                {
                    "to_product_type": "OV",
                    "bonus_type": "DISCOUNT",
                    "bonus_unit": 20,
                    "products": [
                        {
                            "product_name_id": "ssl_basic",
                            "product_name": "Basic OV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_geotrust_truebizid",
                            "product_name": "GeoTrust TrueBusiness ID OV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_securesite_flex",
                            "product_name": "Secure Site OV",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_securesite_pro",
                            "product_name": "Secure Site Pro SSL",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_thawte_webserver",
                            "product_name": "Thawte SSL Webserver OV",
                            "additional_discount": 0
                        }
                    ]
                },
                {
                    "to_product_type": "DV",
                    "bonus_type": "DISCOUNT",
                    "bonus_unit": 10,
                    "products": [
                        {
                            "product_name_id": "ssl_dv_rapidssl",
                            "product_name": "RapidSSL Standard DV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "wildcard_dv_rapidssl",
                            "product_name": "RapidSSL Wildcard DV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_dv_geotrust_flex",
                            "product_name": "GeoTrust DV SSL",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_dv_thawte",
                            "product_name": "Thawte SSL123 DV",
                            "additional_discount": 0
                        }
                    ]
                }
            ]
        },
        {
            "subject": "exampledomain2.com",
            "san_list": [
                "exampledomain2.com"
            ],
            "serial_number": "{{certificate_serial_number}}",
            "issuer_ca": "Sectigo RSA Domain Validation Secure Server CA",
            "issuer_brand": "Sectigo",
            "not_before": "2020-03-16T00:00:00.000+0000",
            "not_after": "2020-06-14T23:59:59.000+0000",
            "validation_type": "DV",
            "matched_domains_count": 1,
            "matched_domains": [
                "exampledomain2.com"
            ],
            "certificate_replacement_benefits": [
                {
                    "to_product_type": "EV",
                    "bonus_type": "DISCOUNT",
                    "bonus_unit": 20,
                    "products": [
                        {
                            "product_name_id": "ssl_ev_basic",
                            "product_name": "Basic EV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_ev_geotrust_truebizid",
                            "product_name": "GeoTrust TrueBusiness ID EV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_ev_securesite_flex",
                            "product_name": "Secure Site EV",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_ev_securesite_pro",
                            "product_name": "Secure Site Pro EV SSL",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_ev_thawte_webserver",
                            "product_name": "Thawte SSL Webserver EV",
                            "additional_discount": 0
                        }
                    ]
                },
                {
                    "to_product_type": "OV",
                    "bonus_type": "DISCOUNT",
                    "bonus_unit": 10,
                    "products": [
                        {
                            "product_name_id": "ssl_basic",
                            "product_name": "Basic OV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_geotrust_truebizid",
                            "product_name": "GeoTrust TrueBusiness ID OV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_securesite_flex",
                            "product_name": "Secure Site OV",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_securesite_pro",
                            "product_name": "Secure Site Pro SSL",
                            "additional_discount": 10
                        },
                        {
                            "product_name_id": "ssl_thawte_webserver",
                            "product_name": "Thawte SSL Webserver OV",
                            "additional_discount": 0
                        }
                    ]
                },
                {
                    "to_product_type": "DV",
                    "bonus_type": "DISCOUNT",
                    "bonus_unit": 30,
                    "products": [
                        {
                            "product_name_id": "ssl_dv_rapidssl",
                            "product_name": "RapidSSL Standard DV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "wildcard_dv_rapidssl",
                            "product_name": "RapidSSL Wildcard DV",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_dv_geotrust_flex",
                            "product_name": "GeoTrust DV SSL",
                            "additional_discount": 0
                        },
                        {
                            "product_name_id": "ssl_dv_thawte",
                            "product_name": "Thawte SSL123 DV",
                            "additional_discount": 0
                        }
                    ]
                }
            ]
        }
    ],
    "page": {
        "total": 2,
        "limit": 1000,
        "offset": 0
    }
}

Request parameters

Name Req/Opt Type Description
domains required array List of domains to check for competitive replacement benefits.

URL query strings

Name Req/Opt Type Description
offset optional int Start list at the specified number for pagination.
Default: 0
limit optional int Truncate list to the specified number for pagination.
Max: 1000 (default)

Response parameters

Name Type Description
certificates array List of objects with competitive replacement details for the certificates that secure each domain in the request.
.. subject string Subject of the certificate.
.. san_list array List of SANs the certificate secures.
.. serial_number string Certificate serial number.
.. issuer_ca string Name of the intermediate or root certificate authority that issued the certificate.
.. issuer_brand string Brand name of the owner of the certificate authority that issued the certificate.
.. not_before string Timestamp when certificate validity starts.
Format: UTC timezone and ISO 8601 date
.. not_after string Timestamp when certificate validity ends.
Format: UTC timezone and ISO 8601 date.
.. validation_type string Validation type used by the certificate.
Possible values: OV, EV, or DV
.. matched_domains_count int Number of domains from your request that this certificate secures.
.. matched_domains array List of domains from your request that this certificate secures.
.. certificate_replacement_benefits array List of objects with information about the discounts and other benefits available for replacing this certificate with a DigiCert product.
.. .. to_product_type string Validation type for the products in this object.
Possible values: OV, EV, or DV.
.. .. bonus_type string Type of benefit available when you replace the certificate with a product in this category.
Possible values: DISCOUNT
.. .. bonus_unit float Percentage discount applied to order cost when you replace the certificate with a product in this category.
.. .. products array A list of objects with information about the products in this category to which the above discounts apply.
.. .. .. product_name_id string Name ID of the DigiCert product.
See Glossary – Product identifiers
.. .. .. product_name string Display name of the DigiCert product.
See Glossary – Product identifiers
.. .. .. additional_discount int Additional percentage discount applied for this product.
page object Details about results. Modified using URL query strings.

Sobre

DigiCert is the world's leading provider of scalable TLS/SSL, IoT and PKI solutions for identity and encryption. The most innovative companies, including 89% of the Fortune 500 and 97 of the 100 top global banks, choose DigiCert for its expertise in identity and encryption for web servers and Internet of Things devices. DigiCert supports TLS and other digital certificates for PKI deployments at any scale through its certificate lifecycle management solution, CertCentral®. The company is recognized for its enterprise-grade certificate management platform, fast and knowledgeable customer support, and market-leading security solutions. For the latest DigiCert news and updates, visit digicert.com or follow @digicert.

©2020 DigiCert, Inc. All rights reserved. DigiCert, its logo and CertCentral are registered trademarks of DigiCert, Inc. Norton and the Checkmark Logo are trademarks of NortonLifeLock Inc. used under license. Other names may be trademarks of their respective owners.