REST API

Documentation


Shipping costs

The costs for shipping and handling of an order depend on the items and country. You don't need to calculate these yourself: you can request the shipping cost from the API before creating an order.

TIP: You can find an indication of the shipping and handling rates in our products list.

Example
Request:
POST /v2/shipping/quote HTTP/1.1
Authorization: Bearer TOKEN
Accept: application/json
Content-Type: application/json

{
    "country": "NL",
    "items": [
        {"productId": "canvas_30x20", "quantity": 1}
    ]
}
Special fields:
Name Details
"country" An ISO 3166-1 alpha 2 country code
"state" Only for U.S. addresses: a ISO 3166-2:US state code
item["productId"] Can be found in the products list
item["pageCount"] Needed only for books and photo prints

The API response contains the cost prices for shipping and handling, excluding VAT. If you use our payment screen, you can find the payment due in the field payment: this is the shipping + handling cost including VAT, rounded up to a consumer-friendly amount.

Response:
HTTP/1.1 200 OK                 
Content-Type: application/json;charset=UTF-8
Content-Length: 109

{
    "shipping": 1.38,
    "handling": 0.40,
    "method": "Brief (50 g)",
    "payment": 2.15,
    "taxRate": 0.21
}
Special fields:
Name Details
"shipping" The shipping cost, excluding VAT.
"handling" The handling cost, excluding VAT.
"method" The selected shipping method.
"payment" The payment due in our payment screen, including VAT.
Next