API Documentation

Cart - Order Price Estimates

The POST priceestimate endpoint is used to estimate cost of the order, including any coupon discounts.

The POST data should be JSON object with following properties set:

ShipToAddress object, with following properties:
- FirstName - required - first name of the user
- LastName - required - last name of the user
- 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
- Email - required - user’s email
- Phone - required - user’s phone
Items array of objects containing the following properties:
- SKU - required - SKU of product variant
- ShipCarrierMethodId - required - ID of shipping carrier method
- Quantity - required - quantity of items with this SKU
- Images - required - list of images, each containing Index of image and ManipCommand
Payment object, with following properties:
- CurrencyCode - required - currency code
CouponCode - optional - a JSON Array of Strings (example: [“coupon_code_1”, “coupon_code_2”])

{
  "ShipToAddress": {
    "FirstName": "Gooten",
    "LastName": "Test",
    "Line1": "222 Broadway",
    "City": "New York",
    "State": "NY",
    "CountryCode": "US",
    "PostalCode": "10038",
    "IsBusinessAddress": false,
    "Phone": "1234567890",
    "Email": "test@gooten.com"
  },
  "Items": [
    {
      "Quantity": 1,
      "SKU": "PhoneCase-GalaxyNote2-Matte",
      "ShipCarrierMethodId": 1,
      "Images": [
        {
          "Url": "https:\/\/printio-widget-live.s3.amazonaws.com\/200E4604-4CD5-4E0C-A131-9F5AF25006E6.jpg",
          "Index": 0,
          "ThumbnailUrl": "https:\/\/printio-widget-live.s3.amazonaws.com\/200E4604-4CD5-4E0C-A131-9F5AF25006E6.jpg",
          "ManipCommand": "",
          "SpaceId": "0"
        }
      ]
    },
    {
      "Quantity": 2,
      "SKU": "PhoneCase-GalaxyNote2-Matte",
      "ShipCarrierMethodId": 1,
      "Images": [
        {
          "Url": "https:\/\/printio-widget-live.s3.amazonaws.com\/200E4604-4CD5-4E0C-A131-9F5AF25006E6.jpg",
          "Index": 0,
          "ThumbnailUrl": "https:\/\/printio-widget-live.s3.amazonaws.com\/200E4604-4CD5-4E0C-A131-9F5AF25006E6.jpg",
          "ManipCommand": "",
          "SpaceId": "0"
        }
      ]
    }
  ],
  "Payment": {
    "CurrencyCode": "USD"
  },
  "CouponCode": [
  	"coupon_code_1",
  	"coupon_code_2"
  ]
}

Example:

This yields the response:

{
  "Items": {
    "Price": 56.16,
    "CurrencyCode": "USD",
    "FormattedPrice": "$56.16",
    "CurrencyFormat": "${1}",
    "CurrencyDigits": 2
  },
  "Shipping": {
    "Price": 5.76,
    "CurrencyCode": "USD",
    "FormattedPrice": "$5.76",
    "CurrencyFormat": "${1}",
    "CurrencyDigits": 2
  },
  "Tax": {
    "Price": 0,
    "CurrencyCode": "USD",
    "FormattedPrice": "$0.00",
    "CurrencyFormat": "${1}",
    "CurrencyDigits": 2
  },
  "HadCouponApply": false,
  "HadError": false
}

Next Step: Submitting an Order