Skip to main content

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 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:

  • 28: DigiCert-provided hardware token with standard shipping

  • 31: DigiCert-provided hardware token with expedited shipping

  • 301: DigiCert KeyLocker provisioning

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:

  • 12: Additional SANs

  • 28: DigiCert-provided hardware token with standard shipping

  • 31: DigiCert-provided hardware token with expedited shipping

  • 301: DigiCert KeyLocker provisioning

.. 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.