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 Product 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)
zip string ZIP or postal code (optional, required for some countries to calculate expedited shipping rates)
items ItemInfo [ ] Array of order items
variant_id string Variant ID of the item ordered
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 USD
Response format:
code integer Response status code 200
result ShippingInfo [ ] Array of shipping rate information
id string Shipping method ID
name string Shipping method name
rate string Shipping rate
currency string Currency code in which the rate is returned (USD unless conversion was requested)
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 expedited shipping rates to California for order that contains 1 poster and 5 T-shirts. (request endpoint is https://api.printful.com/shipping/rates?expedited=1)
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"
        },
        {
            "id": "FEDEX_EXPRESS_SAVER",
            "name": "FedEx Express Saver (3 business days)",
            "rate": "17.74",
            "currency": "USD"
        },
        {
            "id": "FEDEX_2_DAY",
            "name": "FedEx 2 Day (2 business days)",
            "rate": "18.06",
            "currency": "USD"
        },
        {
            "id": "FEDEX_STANDARD_OVERNIGHT",
            "name": "FedEx Standard Overnight (1 business day)",
            "rate": "25.98",
            "currency": "USD"
        }
    ]
}

Ready to try Printful ?

Get Me Started

Printing is what we do best.

Trusted to print 2 075 853 shirts since 2013