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

items

ItemInfo [ ]

Array of order items

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 [ ]

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"
    }]
}