---
title: "Voucher price estimate"
source_url: https://dev.digicert.com/certcentral-apis/services-api/finance/voucher-price-estimate.html
api_method: POST
api_endpoint: "/services/v2/finance/voucher-pricing"
api_url: "https://www.digicert.com/services/v2/finance/voucher-pricing"
---

**POST** `https://www.digicert.com/services/v2/finance/voucher-pricing`

Use this endpoint to get price estimates for a voucher order.

## Example requests and responses

## cURL

```bash
curl --request POST 'https://www.digicert.com/services/v2/finance/voucher-pricing' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "vouchers": [
    {
      "product_name_id": "ssl_basic",
      "no_of_fqdns": 4,
      "no_of_wildcards": 1,
      "validity_years": 3,
      "quantity": 4
    },
    {
      "product_name_id": "ssl_ev_basic",
      "no_of_fqdns": 3,
      "validity_years": 3,
      "quantity": 3
    }
  ],
  "billing_address": {
    "country": "us",
    "state": "Washington",
    "city": "Seattle",
    "zip": "98101"
  }
}'
```

**200 OK**

```
{
  "voucher_prices": [
    {
      "product_name_id": "ssl_basic",
      "no_of_fqdns": 4,
      "no_of_wildcards": 1,
      "validity_years": 3,
      "quantity": 4,
      "cost": 23088
    },
    {
      "product_name_id": "ssl_ev_basic",
      "no_of_fqdns": 3,
      "validity_years": 3,
      "quantity": 3,
      "cost": 13002
    }
  ],
  "total_cost": 36090,
  "total_tax": 3699.23,
  "total_cost_plus_tax": 39789.23,
  "currency": "USD"
}
```

**400 Bad Request**

```
{
  "errors": [
    {
      "code": "cannot_set_both_validity_years_and_validity_days_for_voucher",
      "message": "Cannot set both validity years and validity days for voucher."
    }
  ]
}
```


## 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>vouchers</td>
<td>required</td>
<td>array</td>
<td>List of objects with details about each voucher configuration to request a price estimate for.</td>
</tr>
<tr>
<td>.. product_name_id</td>
<td>required</td>
<td>string</td>
<td>Product name identifier. See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md">Glossary – Product identifiers</a>.</td>
</tr>
<tr>
<td>.. no_of_fqdns</td>
<td>optional</td>
<td>int</td>
<td>Number of FQDN SAN slots.<br>Range: 0-250. Note that the total number of SANs cannot exceed 250.</td>
</tr>
<tr>
<td>.. no_of_wildcards</td>
<td>optional</td>
<td>int</td>
<td>Number of Wildcard SAN slots.<br>Range: 0-250. Note that the total number of SANs cannot exceed 250.</td>
</tr>
<tr>
<td>.. shipping_method</td>
<td>conditional</td>
<td>string</td>
<td>For document and code signing certificates, choose how the requestor will provision or ship the certificates. Usage requirements depend on product type.<br><ul><li><strong>Document signing certificates:</strong><code>shipping_method</code> is required. Allowed values are <code>STANDARD</code> and <code>EXPEDITED</code>. <ul><li><code>shipping_method</code> is <code>STANDARD</code>: For certificates provisioned using preconfigured hardware token with standard shipping, or for certificates provisioned using an existing token. Estimate includes cost of certificates. Preconfigured hardware token and standard shipping are included in certificate cost.</li><li><code>shipping_method</code> is <code>EXPEDITED</code>: For certificates provisioned using a preconfigured hardware token with expedited shipping. Estimate includes cost of certificates and expedited shipping. Preconfigured hardware token is included in certificate cost.</li></ul></li><li><strong>Code signing certificates:</strong><code>shipping_method</code> is optional. Allowed values are <code>STANDARD</code>, <code>EXPEDITED</code>, and <code>KEYLOCKER</code>. <ul><li><code>shipping_method</code> is <code>STANDARD</code> or <code>EXPEDITED</code>: For certificates provisioned using a DigiCert-provided hardware token. Estimate includes cost of certificates, hardware tokens, and hardware token shipping.</li><li><code>shipping_method</code> is <code>KEYLOCKER</code>: For certificates provisioned using <a href="https://docs.digicert.com/en/digicert-one/digicert-keylocker.html" target="_blank" rel="noopener noreferrer">DigiCert KeyLocker</a>. Estimate includes cost of both certificates and DigiCert KeyLocker.</li><li><code>shipping_method</code> omitted: For certificates that will be installed on an existing token or HSM. Estimate includes cost of certificates only.</li></ul></li><li><strong>Other products:</strong><code>shipping_method</code> is not used. Omit from your request.</li></ul></td>
</tr>
<tr>
<td>.. validity_years</td>
<td>conditional</td>
<td>int</td>
<td>The number of years of order coverage.<br>You must provide a value for validity_years or validity_days.<br>Range: Maximum order validity varies by product. To get the maximum order validity period for a product, use the Product info endpoint.</td>
</tr>
<tr>
<td>.. validity_days</td>
<td>conditional</td>
<td>int</td>
<td>The number of days of order coverage.<br>You must provide a value for validity_days or validity_years.<br>Range: Maximum order validity varies by product. To get the maximum order validity period for a product, use the Product info endpoint.</td>
</tr>
<tr>
<td>.. quantity</td>
<td>required</td>
<td>int</td>
<td>Quantity of certificates you want to order with this configuration. Each certificate receives a unique voucher code.<br>Range: 1-1000</td>
</tr>
<tr>
<td>billing_address</td>
<td>optional</td>
<td>object</td>
<td>Billing address details.<br>Used to calculate estimated tax. If not provided, we calculate estimated tax using the billing address associated with the account used to send the request.</td>
</tr>
<tr>
<td>.. country</td>
<td>required</td>
<td>string</td>
<td>Billing country.</td>
</tr>
<tr>
<td>.. city</td>
<td>required</td>
<td>string</td>
<td>Billing city.</td>
</tr>
<tr>
<td>.. state</td>
<td>conditional</td>
<td>string</td>
<td>Billing state or province.<br>Optional for some countries.</td>
</tr>
<tr>
<td>.. zip</td>
<td>conditional</td>
<td>string</td>
<td>Zip/postal code.<br>Optional for some countries.</td>
</tr>
<tr>
<td>.. address</td>
<td>optional</td>
<td>string</td>
<td>Billing address.</td>
</tr>
<tr>
<td>.. address2</td>
<td>optional</td>
<td>string</td>
<td>Continuation of the billing address.</td>
</tr>
</tbody>
</table>

## Response parameters

<table>
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Definition</th>
</tr>
</thead>
<tbody>
<tr>
<td>voucher_prices</td>
<td>array</td>
<td>List of objects with details about each voucher configuration included in the request.</td>
</tr>
<tr>
<td>.. product_name_id</td>
<td>string</td>
<td>Name ID of the product.</td>
</tr>
<tr>
<td>.. no_of_fqdns</td>
<td>int</td>
<td>Number of FQDN SAN slots.</td>
</tr>
<tr>
<td>.. no_of_wildcards</td>
<td>int</td>
<td>Number of Wildcard SAN slots.<br>Range: 0-250</td>
</tr>
<tr>
<td>.. shipping_method</td>
<td>string</td>
<td>Shipping method. Omitted if none exists.</td>
</tr>
<tr>
<td>.. validity_years</td>
<td>int</td>
<td>The number of years of order coverage.<br>Only returned if you use validity_years to specify order validity in the request.</td>
</tr>
<tr>
<td>.. validity_days</td>
<td>int</td>
<td>The number of days of order coverage.<br>Only returned if you use validity_days to specify order validity in the request.</td>
</tr>
<tr>
<td>.. quantity</td>
<td>int</td>
<td>Quantity of certificates you want to order with this configuration.</td>
</tr>
<tr>
<td>.. cost</td>
<td>float</td>
<td>Estimated cost, excluding tax.</td>
</tr>
<tr>
<td>total_cost</td>
<td>float</td>
<td>Estimated total cost, excluding tax.</td>
</tr>
<tr>
<td>total_tax</td>
<td>float</td>
<td>Estimated tax on total cost. Returns <code>0</code> if an error prevents tax calculation.<br><strong>Note:</strong> Estimated tax may change when you place your order.</td>
</tr>
<tr>
<td>total_cost_plus_tax</td>
<td>float</td>
<td>Estimated total cost including tax.</td>
</tr>
<tr>
<td>currency</td>
<td>string</td>
<td>Price estimate currency.</td>
</tr>
</tbody>
</table>