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`*	`"Lorem sed cupidatat"`
`transactionSrc`*	`"sit dolore"`
`AccountNumber`	`"minim laboris culpa consectetur Ut"`

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": "et proident amet Ut",
        "message": "labore laboris Excepteur"
      },
      {
        "code": "velit adipisicing Duis commodo",
        "message": "Ut elit"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "cupidatat",
        "message": "non laboris"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "fugiat elit Duis",
        "message": "occaecat deserunt elit"
      },
      {
        "code": "enim officia anim",
        "message": "commodo deserunt"
      }
    ]
  }
}

{
  "response": {
    "errors": [
      {
        "code": "sit",
        "message": "ut exercitation"
      },
      {
        "code": "proident",
        "message": "sit sint fugiat enim"
      },
      {
        "code": "in ea",
        "message": "minim"
      },
      {
        "code": "tempor ex ipsum aliqua",
        "message": "fugiat"
      }
    ]
  }
}

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

upslogisticsshippingecommercedutiestaxes