Cart – Order Price Estimates

This API request uses the POST priceestimate endpoint and is used to estimate the cost of the order.

Please note that the return prices are the same as the customer prices and it is based on the pricing in the products page in the Gooten Admin.

The POST data for the body should be a JSON object with following parameters:

  • ShipToAddress object, with following properties:
    • Line1 - required - shipping address line 1
    • Line2 - optional - shipping address line 2
    • City - required - shipping city
    • State - optional - shipping state (if applicable)
    • PostalCode - required - shipping postal code
    • CountryCode - required - shipping 2-letter country code
    • Items array of objects containing the following properties:
      • SKU - required - SKU of product variant
      • ShipType - required - the type of shipping method for the order. The values for this field are "Standard", "Expedited", and "Overnight".
      • Quantity - required - quantity of items with this SKU
    • Payment object, with following properties:
      • CurrencyCode - required - currency code

Example:

{
	"ShipToAddress": {
		"Line1": "string",
		"Line2": "string",
		"City": "string",
		"State": "string",
		"CountryCode": "string",
		"PostalCode": "string"
	},
	"Items": [{
		"Quantity": "integer",
		"SKU": "string",
		"ShipType": "string"
	}],
	"Payment": {
		"CurrencyCode": "string"
	}
}

Each API request to the Gooten API must have the RecipeID parameter included in the URL. This is typically used to authenticate to the Gooten API. Please be sure to replace the YourRecipeID in the example with your proper RecipeID from the Gooten Admin.

This yields the response:

{
  "Items": {
    "Price": "decimal",
    "CurrencyCode": "string",
    "FormattedPrice": "string",
    "CurrencyFormat": "string",
    "CurrencyDigits": "integer"
  },
  "Shipping": {
    "Price": "decimal",
    "CurrencyCode": "string",
    "FormattedPrice": "string",
    "CurrencyFormat": "string",
    "CurrencyDigits": "integer"
  },
  "Tax": {
    "Price": "decimal",
    "CurrencyCode": "string",
    "FormattedPrice": "string",
    "CurrencyFormat": "string",
    "CurrencyDigits": "integer"
  },
  "CouponCode": {
    "Price": "decimal",
    "CurrencyCode": "string",
    "FormattedPrice": "string",
    "CurrencyFormat": "string",
    "CurrencyDigits": "integer"
  },
  "CouponType": "string",
  "CouponUsed": "string",
  "HadCouponApply": "boolean",
  "DollarsOff": "decimal",
  "PercentOff": "decimal",
  "HadError": "boolean"
}

Next Step: Validating Shipping Addresses