Compare customer-priced parcel shipping estimates
Compare customer-priced parcel shipping estimates for all products and quantities at the selected physical inventory source. Preview first; copy physicalSource.selected unchanged as fulfillmentSource. Source selections are opaque handoff bundles, not display labels. Insurance defaults to kind: none, the native no-additional-insurance choice; carrier-included baseline coverage is unaffected. An optional kind: native choice names an eligible provider and one insured value for the shipment’s one parcel, with explicit amount and USD currency. Goods/customs declarations remain independent. Supported opt-in requires current account and shipment-update evidence for the insurer, collectibles, carrier, destination, values, signature and claims rules; schema fields alone do not enable coverage. Native full rates expose the premium separately as insuranceAmount, alongside shippingAmount, fulfillmentAmount and configured fees; totalAmount includes those amounts. Delivery confirmation defaults to none. Set deliveryConfirmation to signature or adult_signature for an eligible shipment; delivery and FedEx direct_signature are also admitted. Restricted and other V2-only modes are unavailable through this shared V1 order path. Non-default confirmation excludes Ground Saver, SurePost and Media Mail; omitted or none retains existing configured service behavior. The actual confirmationAmount is an included component of the shipping pricing basis, not an extra amount to add to totalAmount. Customer shipping pricing still applies once to the combined carrier cost or retail comparison. A non-default confirmation requires a current priced selection. Test confirmation is unavailable. A quote prices one parcel at the order’s total weight, and only the warehouse’s configured carrier accounts are offered. Current provider rejection is distinct from an unavailable lookup; no mode is silently substituted. Copy the returned selection, including deliveryConfirmation and insurance, unchanged as shippingQuote for ordinary orders or redemptions. Create revalidates the physical source, recipient, parcels, service, coverage and prices; changed facts require a fresh quote. Vault does not buy the label or insured coverage; creating the order writes the chosen insurance to the warehouse order as a coverage request, and order.current.insurance.label shows the coverage the warehouse’s label reports, once it exists. A quote or creation receipt does not buy or prove insurance. Delivery timing is a carrier estimate when supplied. Import duties, taxes and later adjustments are not guaranteed. Quotes create no order, reservation, label, charge, shipment or price lock. A completed lookup with no eligible service returns quotes: []; incomplete configuration or provider failure is unavailable. Pallet freight retains its separate workflow.
/v1/organizations/{orgId}/shipping-quotesAuthorizationBasic auth · headerrequiredRegistered confidential integration credentials. Keep the secret server-side.
CookieAPI key · headerrequiredConsole-managed Vault session cookie; secure cookie naming may vary by environment.
AuthorizationBearer token (Vault organization API key) · headerrequiredOrganization-owned credential with immutable mode and Read-only or Read/write permissions. Only explicitly declared ordinary customer operations accept it. Test business access refuses until shared Test composition is available; no staff, team, key-management or protocol authority is granted.
orgIdstringrequiredapplication/jsondeliveryConfirmationstringnonedeliverysignatureadult_signaturedirect_signaturelinesobject[]requiredShow propertiesHide properties
objectdeclaredUnitValueobjectShow propertiesHide properties
amountstringrequiredproductIdstringrequiredquantityintegerrequiredrecipientobjectrequiredShow propertiesHide properties
addressLine1stringrequiredaddressLine2stringrequiredcitystringrequiredcompanystringrequiredcountrystringrequiredemailstringrequirednamestringrequiredphonestringrequiredpostalCodestringrequiredregionstringrequiredfulfillmentSourceobjectShow propertiesHide properties
configurationRevisionstringrequiredsourceSignaturestringrequiredphysicalOriginEquivalenceRefstringrequiredv1WarehouseIdintegerrequiredmodestringrequiredconfigurationRevisionstringrequiredsourceSignaturestringrequiredphysicalOriginEquivalenceRefstringrequiredinsuranceobjectShow propertiesHide properties
kindstringrequiredkindstringrequiredpackagesobject[]requiredShow propertiesHide properties
objectamountstringrequiredcurrencystringrequiredproviderstringrequiredcarrierparcelguardshipsurancexcoverSuccess
dataobjectrequiredShow propertiesHide properties
fulfillmentSourceobjectrequiredShow propertiesHide properties
configurationRevisionstringrequiredsourceSignaturestringrequiredphysicalOriginEquivalenceRefstringrequiredv1WarehouseIdintegerrequiredmodestringrequiredconfigurationRevisionstringrequiredsourceSignaturestringrequiredphysicalOriginEquivalenceRefstringrequiredparcelCountintegerrequiredquotesobject[]requiredShow propertiesHide properties
objectserviceobjectrequiredShow propertiesHide properties
namestringrequiredcarrierstringrequireddeliveryobjectrequiredShow propertiesHide properties
daysinteger | nullrequiredShow propertiesHide properties
integernulldatestring | nullrequiredconfirmationAmountobjectrequiredActual native confirmation fee included in the shipping pricing basis. Do not add it to totalAmount again.
Show propertiesHide properties
amountstringrequiredcurrencystringrequiredshippingAmountobjectrequiredShow propertiesHide properties
amountstringrequiredcurrencystringrequiredfulfillmentAmountobjectrequiredShow propertiesHide properties
amountstringrequiredcurrencystringrequiredinsuranceAmountobjectrequiredShow propertiesHide properties
amountstringrequiredcurrencystringrequiredfeesobject[]requiredShow propertiesHide properties
objectnamestringrequiredamountobjectrequiredShow propertiesHide properties
amountstringrequiredcurrencystringrequiredtotalAmountobjectrequiredShow propertiesHide properties
amountstringrequiredcurrencystringrequiredselectionobjectrequiredShow propertiesHide properties
deliveryConfirmationstringnonedeliverysignatureadult_signaturedirect_signatureinsuranceobjectShow propertiesHide properties
kindstringrequiredkindstringrequiredpackagesobject[]requiredShow propertiesHide properties
objectamountstringrequiredcurrencystringrequiredproviderstringrequiredcarrierparcelguardshipsurancexcoverreviewstringrequiredrequestedShippingServicestringrequiredrequestedShippingServiceReviewstringrequiredmetaobjectrequiredShow propertiesHide properties
requestIdstringrequiredError
errorobjectrequiredShow propertiesHide properties
codestringrequiredforbiddeninternal_errornot_foundprovider_data_invalidprovider_outcome_unknownprovider_unavailablerate_limitedstate_conflictunauthenticatedvalidation_errorwarehouse_not_readyfieldsobject[]Show propertiesHide properties
objectcodestringrequiredmessagestringrequiredpathstringrequiredmessagestringrequiredoperationIdstringmetaobjectrequiredShow propertiesHide properties
requestIdstringrequired