Voucher price estimate

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

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

Example requests and responses

Example 1. cURL

curl --request POST 'https://www.digicert.com/services/v2/finance/voucher-pricing' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "vouchers": [
    {
      "product_name_id": "ssl_basic",
      "no_of_fqdns": 4,
      "no_of_wildcards": 1,
      "validity_years": 4,
      "quantity": 4
    },
    {
      "product_name_id": "ssl_ev_basic",
      "no_of_fqdns": 3,
      "validity_years": 6,
      "quantity": 3
    }
  ],
  "billing_address": {
    "country": "us",
    "state": "Washington",
    "city": "Seattle",
    "zip": "98101"
  }
}'

Example 2. 200 OK

{
  "voucher_prices": [
    {
      "product_name_id": "ssl_basic",
      "no_of_fqdns": 4,
      "no_of_wildcards": 1,
      "validity_years": 4,
      "quantity": 4,
      "cost": 23088
    },
    {
      "product_name_id": "ssl_ev_basic",
      "no_of_fqdns": 3,
      "validity_years": 6,
      "quantity": 3,
      "cost": 13002
    }
  ],
  "total_cost": 36090,
  "total_tax": 3699.23,
  "total_cost_plus_tax": 39789.23,
  "currency": "USD"
}

Example 3. 400 Bad Request

{
  "errors": [
    {
      "code": "cannot_set_both_validity_years_and_validity_days_for_voucher",
      "message": "Cannot set both validity years and validity days for voucher."
    }
  ]
}

Request parameters

Name	Req/Opt	Type	Description
vouchers	required	array	List of objects with details about each voucher configuration to request a price estimate for.
.. product_name_id	required	string	Name ID of the product. Supported products: `ssl_securesite_pro`: Secure Site Pro SSL `ssl_ev_securesite_pro`: Secure Site Pro EV SSL `ssl_securesite_flex`: Secure Site OV `ssl_ev_securesite_flex`: Secure Site EV `ssl_basic`: Basic OV `ssl_ev_basic`: Basic EV `ssl_geotrust_truebizid`: GeoTrust TrueBusiness ID OV `ssl_ev_geotrust_truebizid`: GeoTrust TrueBusiness ID EV `ssl_thawte_webserver`: Thawte SSL Webserver OV `ssl_ev_thawte_webserver`: Thawte SSL Webserver EV `ssl_dv_geotrust_flex`: GeoTrust DV SSL `ssl_dv_thawte`: Thawte SSL123 DV `ssl_dv_ee`: Encryption Everywhere DV `code_signing`: Code Signing Certificate `code_signing_ev`: EV Code Signing Certifcate
.. no_of_fqdns	optional	int	Number of FQDN SAN slots. Range: `0`-`250`. Note that the total number of SANs cannot exceed 250.
.. no_of_wildcards	optional	int	Number of Wildcard SAN slots. Range: `0`-`250`. Note that the total number of SANs cannot exceed 250.
.. shipping_method	conditional	string	Shipping method. Required for EV code signing certificates. Not used for other product types. Allowed values:`STANDARD` or `EXPEDITED`
.. validity_years	conditional	int	The number of years of order coverage. You must provide a value for `validity_years` or `validity_days`. Range: `1`-`6` Note: Maximum order validity varies by product. To get the maximum order validity period for a product, use the Product info endpoint.
.. validity_days	conditional	int	The number of days of order coverage. You must provide a value for `validity_days` or `validity_years`. Note: Maximum order validity varies by product. To get the maximum order validity period for a product, use the Product info endpoint.
.. quantity	required	int	Quantity of certificates you want to order with this configuration. Each certificate receives a unique voucher code. Range: `1`-`1000`
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	conditional	string	Billing state or province. Optional for some countries.
.. zip	conditional	string	Zip/postal code. Optional for some countries.
.. address	optional	string	Billing address.
.. address2	optional	string	Continuation of the billing address.

Response parameters

Name	Type	Definition
voucher_prices	array	List of objects with details about each voucher configuration included in the request.
.. product_name_id	string	Name ID of the product.
.. no_of_fqdns	int	Number of FQDN SAN slots.
.. no_of_wildcards	int	Number of Wildcard SAN slots. Range: `0`-`250`
.. shipping_method	string	Shipping method. Only returned for EV code signing certificates.
.. validity_years	int	The number of years of order coverage. Only returned if you use `validity_years` to specify order validity in the request.
.. validity_days	int	The number of days of order coverage. Only returned if you use `validity_days` to specify order validity in the request.
.. quantity	int	Quantity of certificates you want to order with this configuration.
.. cost	float	Estimated cost, excluding tax.
total_cost	float	Estimated total cost, excluding tax.
total_tax	float	Estimated tax on total cost. Returns `0` if an error prevents tax calculation. Note: Estimated tax may change when you place your order.
total_cost_plus_tax	float	Estimated total cost including tax.
currency	string	Price estimate currency.

In this section:

Voucher price estimate

Example requests and responses

Request parameters

Response parameters

Search results