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 |