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

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

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

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

int

array

.. subtotal

int

Add-ons cost subtotal. Calculated by multiplying units by additional_name_price.

.. product_id

int

Possible values: 12 (additional SAN)

.. units

int

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.