Shipping Rate API
The Shipping rate API calculates the shipping rates for an order based on the recipient's location and the contents of the order.
The returned shipping rate ID can be used to specify the shipping method when creating an order.
See Country API for information about the Country codes.
See Printful Catalog API for information about the Variant IDs.
Calculate shipping rates
POST https://api.printful.com/shipping/rates
Returns available shipping options and rates for the given list of products.
Input parameters:
Response format:
| Request body | ShippingRequest | Order information | ||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||
| code | integer | Response status code 200 | ||||||||||||||||||
| result | ShippingInfo [ ] | |||||||||||||||||||
|
||||||||||||||||||||
| API key | ||
| Request body | ||
| Execute | ||
Calculate shipping rates to US for order that contains 1 poster and 5 T-shirts.
Request body:
{
"recipient": {
"address1": "19749 Dearborn St",
"city": "Chatsworth",
"country_code": "US",
"state_code": "CA",
"zip": 91311
},
"items": [
{
"quantity": 1,
"variant_id": 2
},
{
"quantity": 5,
"variant_id": 202
}
]
}
Response data:
{
"code": 200,
"result": [{
"id": "STANDARD",
"name": "Flat Rate (3-5 business days)",
"rate": "18.45",
"currency": "USD"
}]
}
Calculate shipping rates to US for order that contains items with external(your) variant id
Request body:
{
"recipient": {
"address1": "19749 Dearborn St",
"city": "Chatsworth",
"country_code": "US",
"state_code": "CA",
"zip": 91311
},
"items": [
{
"quantity": 1,
"external_variant_id": 2
},
{
"quantity": 5,
"variant_id": 202
}
]
}
Response data:
{
"code": 200,
"result": [{
"id": "STANDARD",
"name": "Flat Rate (3-5 business days)",
"rate": "18.45",
"currency": "USD"
}]
}
Calculate shipping rates to US for order that contains items with Warehouse variant id
Request body:
{
"recipient": {
"address1": "19749 Dearborn St",
"city": "Chatsworth",
"country_code": "US",
"state_code": "CA",
"zip": 91311
},
"items": [
{
"quantity": 1,
"warehouse_product_variant_id": 2
},
{
"quantity": 5,
"variant_id": 202
}
]
}
Response data:
{
"code": 200,
"result": [{
"id": "STANDARD",
"name": "Flat Rate (3-5 business days)",
"rate": "18.45",
"currency": "USD"
}]
}
