UPS Landed Cost Quote Virtual Sandbox

Estimate international shipment costs including duties, taxes, and brokerage fees.

The Landed Cost Quote API provides all-inclusive cost estimates for international shipments. It calculates duties, VAT, taxes, and brokerage fees based on commodity details, origin, and destination, helping businesses improve operational efficiency and customer transparency.

Use this hosted sandbox to simulate UPS Landed Cost Quote APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate landed cost calculation payloads, test commodity-specific duty and tax logic, simulate various international shipping scenarios, and verify error handling for invalid origin/destination or currency combinations before production integration.

UPS Landed Cost Quote virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate UPS Landed Cost Quote responses instantly.

`https://ups-landed-cost.mock.beeceptor.com`

Landed Cost

POST

/landedcost/{version}/quotes

The Landed Cost Quote API allows you to estimate the all-inclusive cost of international shipments - including applicable duties, VAT, taxes, brokerage fees, and other fees. Required parameters include the currency and shipment details, such as the commodity ID, price, quantity, and country code of

Header Name	Example
`transId`*	`"fugiat"`
`transactionSrc`*	`"exercitation Lorem irure mollit aliquip"`
`AccountNumber`	`"aute est irure"`

Request Payload

{
  "currencyCode": "GBP",
  "transID": "325467165",
  "allowPartialLandedCostResult": false,
  "shipment": {
    "id": "ShipmentID83",
    "importCountryCode": "GB",
    "importProvince": "",
    "shipDate": "",
    "exportCountryCode": "US",
    "incoterms": "",
    "shipmentItems": [
      {
        "commodityId": "1",
        "grossWeight": "",
        "grossWeightUnit": "",
        "priceEach": "125",
        "hsCode": "400932",
        "quantity": 24,
        "UOM": "Each",
        "originCountryCode": "GB",
        "commodityCurrencyCode": "GBP",
        "description": ""
      },
      {
        "commodityId": "4",
        "grossWeight": "",
        "grossWeightUnit": "",
        "priceEach": "0.5",
        "hsCode": "",
        "quantity": 900,
        "UOM": "Each",
        "originCountryCode": "GB",
        "commodityCurrencyCode": "GBP",
        "description": "Cord5mm{PK50Yellow/Red"
      }
    ],
    "transModes": "",
    "transportCost": "",
    "shipmentType": "Sale"
  }
}

Response Payload

{
  "shipment": {
    "currencyCode": "GBP",
    "id": "ShipmentID83",
    "brokerageFeeItems": [
      {
        "chargeName": "DisbursementFee",
        "chargeAmount": 19.05
      },
      {
        "chargeName": "EntryPreparationFee",
        "chargeAmount": 5.6
      }
    ],
    "totalBrokerageFees": 24.65,
    "totalDuties": 60,
    "totalCommodityLevelTaxesAndFees": 0,
    "totalShipmentLevelTaxesAndFees": 0,
    "totalVAT": 702,
    "totalDutyandTax": 762,
    "grandTotal": 786.65,
    "importCountryCode": "GB",
    "shipmentItems": [
      {
        "commodityId": "1",
        "commodityDuty": 60,
        "totalCommodityTaxesAndFees": 0,
        "commodityVAT": 612,
        "totalCommodityDutyandTax": 672,
        "commodityCurrencyCode": "GBP",
        "isCalculable": true,
        "hsCode": "4009320090"
      },
      {
        "commodityId": "4",
        "commodityDuty": 0,
        "totalCommodityTaxesAndFees": 0,
        "commodityVAT": 90,
        "totalCommodityDutyandTax": 90,
        "commodityCurrencyCode": "GBP",
        "isCalculable": true,
        "hsCode": "8546901000"
      }
    ]
  },
  "alversion": 0,
  "dpversion": null,
  "transID": "325467165",
  "error": null,
  "perfStats": {
    "absLayerTime": "139",
    "fulfillTime": "ThuFeb027:56:53.231-05:002023",
    "receiptTime": "ThuFeb027:56:53.091-05:002023"
  }
}

{
  "response": {
    "errors": [
      {
        "code": "qui esse sit",
        "message": "eiusmod anim veniam"
      },
      {
        "code": "eu",
        "message": "non dolor nulla enim"
      },
      {
        "code": "ea laborum veniam laboris",
        "message": "ut fugiat"
      },
      {
        "code": "in ea veniam Excepteur dolor",
        "message": "sunt aute dolore nulla adipisicing"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "ut",
        "message": "irure veniam fugiat enim"
      },
      {
        "code": "aliqua in",
        "message": "commodo consectetur"
      },
      {
        "code": "ullamco ut",
        "message": "officia pariatur voluptate sit Ut"
      },
      {
        "code": "non cillum",
        "message": "veniam Lorem id ut"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "commodo dolore",
        "message": "velit enim"
      },
      {
        "code": "laboris quis cillum in",
        "message": "qui ullamco in sunt veniam"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "sint aliquip",
        "message": "sint cupidatat nisi"
      },
      {
        "code": "Ut nulla minim dolore in",
        "message": "ex elit"
      },
      {
        "code": "tempor Excepteur aliqua cupidatat",
        "message": "magna in veniam sed pariatur"
      },
      {
        "code": "minim",
        "message": "ut labore"
      },
      {
        "code": "ad consectetur et incididunt",
        "message": "do enim occaecat sed in"
      }
    ]
  }
}

Service Homepage: github.com/UPS-API/api-documentation/blob/main/LandedCost-Ready.yaml

upslogisticsshippingecommercedutiestaxes