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:
Request body ShippingRequest Order information
recipient AddressInfo Recipient location information
address1 string Address line 1
city string City
country_code string Country code
state_code string State code (optional, required for United States, Australia and Canada)
zip string ZIP or postal code (optional, required for some countries to calculate expedited shipping rates)
phone string Phone number (optional)
items ItemInfo [ ] Array of order items
variant_id string Catalog Variant ID of the item ordered. See Product Catalog API

* Required if no other IDs given
external_variant_id string External Variant ID of the item ordered. See Ecommerce Platform Sync API.

* Required if no other IDs given
warehouse_product_variant_id string Warehouse product variant ID of the item ordered. See Warehouse Products API.

* Required if no other IDs given
quantity integer Number of items ordered
value string Item retail value - optional but can help to properly calculate insurance costs for large orders
currency string 3 letter currency code (optional), required if the rates need to be converted to another currency instead of store default currency
locale string Locale in which shipping rate names will be returned. Available options - 'en_US' (default), 'es_ES'
Response format:
code integer Response status code 200
result ShippingInfo [ ]
id string Shipping method ID
name string Shipping method name
rate string Shipping rate
currency string Currency code in which the rate is returned
minDeliveryDays int Estimated minimum delivery days. Warning this value may not be present in response.
maxDeliveryDays int Estimated maximum delivery days. Warning this value may not be present in response.
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"
    }]
}

Ready to try Printful ?

Get started