API Documentation

Getting Price Estimate for an Order

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