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

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

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


> **Info**
>
> If an estimate can't be determined, the endpoint returns a price estimate of `0`.


## Example requests and responses

## cURL

```bash
curl -X POST \
  https://www.digicert.com/services/v2/finance/order-pricing \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
  "certificate": {
    "dns_names": [
      "example.com",
      "example.net",
      "example.org"
    ]
  },
  "validity_years": 1,
  "product_name_id": "ssl_basic",
  "renewal_of_order_valid_till": "2024-06-20"
}'
```

## 200 OK

```json
{
    "base_price": 782,
    "total_price": 782,
    "addons_price": 0,
    "san_package_price": 0,
    "benefits_discount_total": 0,
    "fqdns": {
        "subtotal": 0,
        "units": 0
    },
    "wildcards": {
        "subtotal": 0,
        "units": 0
    },
    "balance": 0,
    "currency": "USD",
    "tax": "0.00",
    "tax_error": false
}
```

## 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>certificate</td>
<td>required</td>
<td>object</td>
<td>Details about the domains to secure.</td>
</tr>
<tr>
<td>.. dns_names</td>
<td>required</td>
<td>array</td>
<td>List of domains to secure with the certificate.</td>
</tr>
<tr>
<td>order_validity</td>
<td>required</td>
<td>object</td>
<td>Object with order validity details. Used in products that allow multi-year plans. When used, overrides <code>validity_years</code>.</td>
</tr>
<tr>
<td>.. years</td>
<td>required</td>
<td>number</td>
<td>Order validity (years).</td>
</tr>
<tr>
<td>.. days</td>
<td>required</td>
<td>number</td>
<td>Order validity (days).</td>
</tr>
<tr>
<td>.. custom_expiration_date</td>
<td>optional</td>
<td>string</td>
<td>Custom expiration date for the order.</td>
</tr>
<tr>
<td>validity_years</td>
<td>required</td>
<td>int</td>
<td>Validity period for the order, in years.<br>Allowed values: Varies by product type. For valid ranges, see the Order endpoint documentation for the product that you want a price estimate for.</td>
</tr>
<tr>
<td>is_out_of_contract</td>
<td>optional</td>
<td>int</td>
<td>If the account is under a contract, specify if the request should return the non-contract price.<br>Allowed values:0 (contract price), 1 (non-contract price)<br>Default:
0</td>
</tr>
<tr>
<td>product_name_id</td>
<td>required</td>
<td>string</td>
<td>Certificate product to order. See Glossary – Product identifiers.</td>
</tr>
<tr>
<td>billing_address</td>
<td>optional</td>
<td>object</td>
<td>Billing address details. 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>required</td>
<td>string</td>
<td>Billing state or province. Optional for some countries.</td>
</tr>
<tr>
<td>.. zip</td>
<td>required</td>
<td>string</td>
<td>Zip/postal code. Optional for some countries.</td>
</tr>
<tr>
<td>renewal_of_order_valid_till</td>
<td>optional</td>
<td>string</td>
<td>If estimating the price of a renewal order, include the expiration date of the order being renewed.<br>Format: YYYY-MM-DD (for example, "2026-12-26")</td>
</tr>
<tr>
<td>addons</td>
<td>optional</td>
<td>array of strings</td>
<td>List of product IDs for order add-ons to include in the price estimate.<br>When requesting a price estimate for Code Signing or EV Code Signing orders that will be provisioned using a DigiCert-provided hardware token or DigiCert KeyLocker, make sure to include the ID of the corresponding add-on. Otherwise, your price estimate may not be accurate.<br><strong>Allowed values:</strong><br><ul><li><code>28</code>: DigiCert-provided hardware token with standard shipping</li><li><code>31</code>: DigiCert-provided hardware token with expedited shipping</li><li><code>301</code>: DigiCert KeyLocker provisioning</li></ul></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>base_price</td>
<td>int</td>
<td>Base cost for the specified product type.</td>
</tr>
<tr>
<td>total_price</td>
<td>int</td>
<td>Total cost estimate for the order, including estimated tax.</td>
</tr>
<tr>
<td>addons_price</td>
<td>int</td>
<td>Cost of all add-ons.</td>
</tr>
<tr>
<td>addons_price_details</td>
<td>array</td>
<td>Details about order add-ons. Omitted from response if the request does not include add-ons .</td>
</tr>
<tr>
<td>.. subtotal</td>
<td>int</td>
<td>Add-ons cost subtotal. Calculated by multiplying units by additional_name_price.</td>
</tr>
<tr>
<td>.. product_id</td>
<td>int</td>
<td>Product ID of the add-on.<br>Possible values:<br><ul><li><code>12</code>: Additional SANs</li><li><code>28</code>: DigiCert-provided hardware token with standard shipping</li><li><code>31</code>: DigiCert-provided hardware token with expedited shipping</li><li><code>301</code>: DigiCert KeyLocker provisioning</li></ul></td>
</tr>
<tr>
<td>.. units</td>
<td>int</td>
<td>Number of add-ons added to the order.</td>
</tr>
<tr>
<td>.. price</td>
<td>string</td>
<td>Per-unit cost of the product add-on.</td>
</tr>
<tr>
<td>fqdns</td>
<td>object</td>
<td>Object with details about the price estimate for FQDNs on the order.</td>
</tr>
<tr>
<td>.. subtotal</td>
<td>int</td>
<td>Price estimate for FQDNs on the order.</td>
</tr>
<tr>
<td>.. units</td>
<td>int</td>
<td>Number of FQDNs on the order.</td>
</tr>
<tr>
<td>wildcards</td>
<td>object</td>
<td>Object with details about the price estimate for wildcards on the order.</td>
</tr>
<tr>
<td>.. subtotal</td>
<td>int</td>
<td>Price estimate for wildcards on the order.</td>
</tr>
<tr>
<td>.. units</td>
<td>int</td>
<td>Number of wildcards on the order.</td>
</tr>
<tr>
<td>balance</td>
<td>int</td>
<td>Current account balance.</td>
</tr>
<tr>
<td>currency</td>
<td>string</td>
<td>Currency code for the monetary values in this estimate.<br>Possible values: See Glossary – DigiCert currencies.</td>
</tr>
<tr>
<td>tax</td>
<td>float</td>
<td>Estimated tax for the order.<br>Returns 0 if an error prevents tax calculation.<br>Note: Estimated tax may change when you place the order.</td>
</tr>
<tr>
<td>tax_error</td>
<td>bool</td>
<td>Returns <code>true</code> if an internal error prevents tax calculation.</td>
</tr>
</tbody>
</table>