---
title: "List replacement benefits"
source_url: https://dev.digicert.com/certcentral-apis/services-api/finance/list-replacement-benefits.html
api_method: POST
api_endpoint: "/services/v2/competitive-replacement/certificates"
api_url: "https://www.digicert.com/services/v2/competitive-replacement/certificates"
---

**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.


> **Info**
>
> To use this endpoint, competitive replacement must be enabled and configured for your account. Contact your account manager or our <a href="https://www.digicert.com/contact-us/" target="_blank" rel="noopener noreferrer">support team</a> to have this feature enabled.


## Example requests and response

**cURL**

```bash
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**

```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**

```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**

```javascript
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

```json
{
    "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

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>domains</td>
<td>required</td>
<td>array</td>
<td>List of domains to check for competitive replacement benefits.</td>
</tr>
</tbody>
</table>

## URL query strings

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>offset</td>
<td>optional</td>
<td>int</td>
<td>Start list at the specified number for pagination.<br>Default: 0</td>
</tr>
<tr>
<td>limit</td>
<td>optional</td>
<td>int</td>
<td>Truncate list to the specified number for pagination.<br>Max: 1000 (default)</td>
</tr>
</tbody>
</table>

## Response parameters

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