Price estimate

3 minute read

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

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

Note

If an estimate can’t be determined, the endpoint returns a price estimate of 0.

Example requests and responses

cURL

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

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

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 `validity_years`.
.. 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:0 (contract price), 1 (non-contract price) Default:
0
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:
YYYY-MM-DD
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 units by additional_name_price.
.. 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 0 if an error prevents tax calculation. Note: Estimated tax may change when you place the order.
tax_error	bool	Returns `true` if an internal error prevents tax calculation.