Shipping quotes quickstart

The shipping quote API lets your own checkout show your customers the shipping choices and prices you set up in Zippendo. You send the cart and the delivery address; Zippendo answers with one rate for each of your shipping rules that fits that cart.

When to use it

A custom or headless webshop with its own checkout
An app that needs shipping prices before it creates a shipment
A checkout where one flat rate is not enough

Shopify and WooCommerce don’t need this API: Zippendo serves their checkout rates for you. See Shipping quotes. Use the API when your own checkout needs the prices.

Request

Send the cart and destination to POST /orgs/{orgId}/shipping-quote:

curl -X POST https://api.zippendo.com/orgs/{orgId}/shipping-quote \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": {
      "country": "DK",
      "postalCode": "2100",
      "city": "Copenhagen"
    },
    "items": [
      {
        "name": "T-shirt",
        "quantity": 1,
        "grams": 250,
        "price": 29900
      }
    ],
    "currency": "DKK"
  }'

price is the unit price in the smallest currency unit (øre for DKK, cents for EUR), and grams is the unit weight. Add totalPriceCents with the cart total after discounts if your shipping rules look at the order value.

Response

{
  "rates": [
    {
      "serviceName": "Standard DK",
      "serviceCode": "postnord:PNL13:rule_01HZX9K2QF",
      "totalPrice": "3900",
      "currency": "DKK",
      "carrierName": "PostNord",
      "carrierSlug": "postnord",
      "productId": "PNL13",
      "shippingRuleId": "rule_01HZX9K2QF"
    }
  ]
}

Zippendo checks each shipping rule whose Receiving countries include destination.country. Every rule whose Shipping conditions match the cart becomes one rate, named after the rule and priced by its matching condition (the lowest price, if several match). totalPrice is in the smallest currency unit, as a string. When no rule matches, you get { "rates": [] }, so show a fallback at checkout in that case. The full field list is in Shipping quotes and the API reference.

Requirements

At least one connected carrier
At least one shipping rule for the countries you ship to. The rules decide which rates appear and what they cost.
An API token with the read:shipping_rules permission. See the REST API quickstart.

Start

Quickstarts

Fulfillment flow

Connections

Operations

Organization & account

Shipping quotes quickstart

When to use it

Request

Response

Requirements

Next steps

Shipping rules

API reference

​When to use it

​Request

​Response

​Requirements

​Next steps

Shipping rules

API reference

When to use it

Request

Response

Requirements

Next steps