Shipping
Calculate shipping rates
Calculates shipping rates for a list of items. The endpoint computes the total weight and volume of the items (model and optional packaging), selects the appropriate envelope, and returns the carrier services available for the destination with their price. Only services whose price is greater than 0 are returned. To the United Kingdom (GB), the Sendcloud services (Colissimo International…) are not returned: the carrier refuses their label without the sender's UK VAT and EORI numbers, and order creation refuses them (GB_CUSTOMS_NUMBERS_REQUIRED). Use lpf_international to GB. The route stays public; an optional Bearer API key names the account.
Request
Authorization
None: this route answers without an API key.
Body application/json
to_countrystringrequiredISO 2-letter destination country code.to_postal_codestringDestination postal code (reserved for postal-code-aware pricing).itemsarray of objectrequiredItems to ship. Weight and volume are derived from each model (and optional packaging).items[].productIdstring:pvccard_white,mifare1k_pvccard_white,ntag213_pvccard_white,ntag216_pvccard_white,ntag424_pvccard_white,ntag424_woodcardrequiredProduct ID of the item.items[].packagingIdstring, nullableOptional packaging ID, added to the item weight and volume.items[].quantityintegerNumber of units for this item.
Responses
200Successfully calculated shipping rates
successbooleanweightintegerTotal shipping weight in grams (items + envelope).volumenumberTotal items volume in cm³.envelopeShippingEnvelopecountintegercarriersarray of ShippingRate
400Bad request, missing to_country or items
Type: Error
404No matching models found for the provided items
Type: Error
429
500Server error
Type: Error