Price estimate
POST https://www.digicert.com/services/v2/finance/order-pricing
Use this endpoint to get price estimates for a certificate order.
Notice
If an estimate can't be determined, the endpoint returns a price estimate of 0.
Example requests and responses
Request parameters
| Name | Req/Opt | Type | Description | 
|---|---|---|---|
| certificate | required | object | Details about the domains to secure. | 
| .. dns_names | required | array | List of domains to secure with the certificate. | 
| order_validity | required | object | Object with order validity details. Used in products that allow multi-year plans. When used, overrides  | 
| .. years | required | number | Order validity (years). | 
| .. days | required | number | Order validity (days). | 
| .. custom_expiration_date | optional | string | Custom expiration date for the order. | 
| validity_years | required | int | Validity period for the order, in years. Allowed values: Varies by product type. For valid ranges, see the Order endpoint documentation for the product that you want a price estimate for. | 
| is_out_of_contract | optional | int | If the account is under a contract, specify if the request should return the non-contract price. Allowed values: Default: | 
| product_name_id | required | string | Certificate product to order. See Glossary – Product identifiers. | 
| billing_address | optional | object | 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. | 
| .. country | required | string | Billing country. | 
| .. city | required | string | Billing city. | 
| .. state | required | string | Billing state or province. Optional for some countries. | 
| .. zip | required | string | Zip/postal code. Optional for some countries. | 
| renewal_of_order_valid_till | optional | string | If estimating the price of a renewal order, include the expiration date of the order being renewed. Format: | 
| addons | optional | array of strings | List of product IDs for order add-ons to include in the price estimate. 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. Allowed values: 
 | 
Response parameters
| Name | Type | Description | 
|---|---|---|
| base_price | int | Base cost for the specified product type. | 
| total_price | int | Total cost estimate for the order, including estimated tax. | 
| addons_price | int | Cost of all add-ons. | 
| addons_price_details | array | Details about order add-ons. Omitted from response if the request does not include add-ons . | 
| .. subtotal | int | Add-ons cost subtotal. Calculated by multiplying  | 
| .. product_id | int | Product ID of the add-on. Possible values: 
 | 
| .. units | int | Number of add-ons added to the order. | 
| .. price | string | Per-unit cost of the product add-on. | 
| fqdns | object | Object with details about the price estimate for FQDNs on the order. | 
| .. subtotal | int | Price estimate for FQDNs on the order. | 
| .. units | int | Number of FQDNs on the order. | 
| wildcards | object | Object with details about the price estimate for wildcards on the order. | 
| .. subtotal | int | Price estimate for wildcards on the order. | 
| .. units | int | Number of wildcards on the order. | 
| balance | int | Current account balance. | 
| currency | string | Currency code for the monetary values in this estimate. Possible values: See Glossary – DigiCert currencies. | 
| tax | float | Estimated tax for the order. Returns  Note: Estimated tax may change when you place the order. | 
| tax_error | bool | Returns  |