Obtaining the 3D printing price of a design¶

Depending on the design, material, scale and quantity, the price of 3D printing may vary. This API allows to query the price that would be billed to 3D print a given design.

The price API is accessible via a GET request to the following URL:

PRICE_URL: https://www.sculpteo.com/en/api/design/3D/price_by_uuid/

The following parameters may be appended to the URL. Only the uuid parameter is required.

uuid

UUID of the design on which to get printing price

quantity

number of copies (default ‘1’)

scale

scale of the design (default ‘1.0’)

unit

unit of the design (‘mm’, ‘cm’, ‘m’, ‘in’, ‘ft’, ‘yd’, default ‘cm’)

currency

currency in which price is returned (ISO-4217: ‘EUR’, ‘USD’, ‘GBP’ are supported, defaults to currency from geolocalized IP of the request)

productname

printing material (see product list below, default ‘white_plastic’ or ‘color_plastic’ if design has colors or textures).

The products available for ‘productname’ are listed in Materials. If you are looking to get the price of a design for multiple materials in a single request, separate the materials by a “,” in the productname field. For example: productname=white_plastic,black_plastic which translates into white_plastic%2black_plastic in the url.

The response is a JSON-encoded object containing the following keys:

body

body object described below

error

object containing a ‘description’ string property describing the error and an integer ‘id’ property for the error number. If the ‘id’ of the error is not 0, the request failed, and the body may be empty

warning

optional string indicating that the request was successful but with a warning

E.g.: There is a potential warning if the design is too small:

{"body": { ..., "warning": "Design has fine details which might break, please check its solidity", ... }, ... }

You also can use it indirectly via sculpteo.widget.js:

<script type="text/javascript">
/* <![CDATA[ */
    sculpteo.design("#uuid", function(design) {
        design[0].get_price();
    });
/* ]]> */
</script>

The body object contains the following properties: :price: the price Object :delivery: Expected delivery time (see below) :success: a boolean indicating if request succeeded or failed

The price object contains the following properties:

unit_price

The formatted price per unit (rounded to 2 decimals)

unit_price_raw

Same as above without currency

total_cost

The formatted total cost (unit_price * quantity rounded to 2 decimals)

total_cost_raw

Same as above without currency

unit_price_without_discount

The formatted price per unit without any discount (indicative)

unit_price_without_discount_raw

Same as above without currency

total_cost_without_discount

The formatted total cost without any discount (indicative)

total_cost_without_discount_raw

Same as above without currency

unit_price_round

The formatted unit price rounded to integer (indicative)

profit_raw

The profit margin for the designer of the design

discount

Discount percentage

has_tax

Is true or false. Based on the geolocalisation of your IP.

The expected delivery time object contains the following properties:

receipt_timer

localized timeout of date estimate

receipt_date

expected delivery date in ISO format (using selected material)

shipped_delta

current shipping delay in days (using selected material)