View DHL Services

DHL Quotes API Virtual Sandbox

Obtain accurate shipping quotes and duty/tax estimates for DHL eCommerce shipments.

The DHL Quotes API allows developers to retrieve shipping quotes, including duty and tax calculations, for international shipments. It supports complex request structures involving origin, destination, and parcel details to provide precise cost estimates for logistics integrations.

Use this hosted sandbox to simulate DHL Quotes API 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 shipping quote request payloads, verify duty and tax calculation logic, test handling of mandatory vs. optional parcel data, and ensure your application correctly parses DHL's multi-part response schemas for various international shipping scenarios.

DHL Quotes API virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate DHL Quotes API responses instantly.

https://dhl-quotes.mock.beeceptor.com



General

Header NameExample
User-Agent"sed fugiat ea"
Request Payload
{
  "pickupAccount": 9999999,
  "itemSeller": "dhl-adrianne.myshopify.com",
  "senderAddress": {
    "state": "NY",
    "country": "USD"
  },
  "consigneeAddress": {
    "state": "BC",
    "country": "CA"
  },
  "packageDetails": {
    "freightCharge": {
      "currency": "USD",
      "value": 10
    },
    "outputCurrency": "USD",
    "clearanceMode": "COURIER",
    "transportMode": "AIR",
    "endUse": "Personal"
  },
  "customDetails": {
    "itemId": "ITEM_01",
    "hsCode": 210690,
    "skuNumber": "sku-54321-01",
    "countryOfOrigin": "US",
    "qualifiesForPreferentialTariffs": true,
    "itemQuantity": {
      "unit": "EA",
      "value": 1
    },
    "itemValue": {
      "currency": "USD",
      "value": 1000
    },
    "weight": {
      "unit": "LB",
      "value": 4.5
    }
  }
}
Response Payload
{
  "quoteId": "38d43d1c-732b-40bf-91d7-59896f8e33ac",
  "pickupAccount": 9999999,
  "itemSeller": "dhl.adrianne.myshopify.com",
  "pricingStrategy": "AVERAGE",
  "feeTotals": [
    {
      "name": "DUTY",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "EXCISE",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "GST",
      "currency": "USD",
      "value": 50
    },
    {
      "name": "HST",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "PST",
      "currency": "USD",
      "value": 70
    },
    {
      "name": "QST",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "SURTAX",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "TARIFF",
      "currency": "USD",
      "value": 0
    }
  ],
  "consigneeAddress": {
    "state": "BC",
    "country": "CA"
  },
  "packageDetails": {
    "freightCharge": {
      "value": 10,
      "currency": "USD"
    },
    "insuranceCharge": {
      "value": 0,
      "currency": "USD"
    },
    "outputCurrency": "USD",
    "clearanceMode": "COURIER",
    "transportMode": "AIR",
    "endUse": "PERSONAL",
    "packageFees": null
  },
  "customDetails": {
    "itemID": "ITEM_01",
    "hsCode": 210690,
    "hsCodeApplied": 210690,
    "skuNumber": "sku-54321-01",
    "countryOfOrigin": "US",
    "qualifiesForPreferentialTariffs": true
  },
  "itemQuantity": {
    "value": 1,
    "unit": "EA"
  },
  "itemValue": {
    "value": 1000,
    "currency": "USD"
  },
  "itemFreight": {
    "value": 10,
    "currency": "USD"
  },
  "itemInsurance": {
    "value": 0,
    "currency": "USD"
  },
  "weight": {
    "value": 4.5,
    "unit": "LB"
  },
  "itemFees": [
    {
      "name": "PST",
      "currency": "USD",
      "value": 70
    },
    {
      "name": "QST",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "TARIFF",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "DUTY",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "HST",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "GST",
      "currency": "USD",
      "value": 50
    },
    {
      "name": "EXCISE",
      "currency": "USD",
      "value": 0
    },
    {
      "name": "SURTAX",
      "currency": "USD",
      "value": 0
    }
  ],
  "senderAddress": {
    "state": "NY",
    "country": "US"
  },
  "info": null
}
{
  "invalidParams": [
    {
      "name": "originCountry",
      "path": "/pricingStrategy",
      "reason": "Required field missing"
    },
    {
      "name": "pricingStrategy",
      "path": "/pricingStrategy",
      "reason": "Invalid format"
    },
    {
      "name": "pricingStrategy",
      "path": "/destinationCountry",
      "reason": "Required field missing"
    },
    {
      "name": "pricingStrategy",
      "path": "/originCountry",
      "reason": "Invalid format"
    }
  ],
  "quoteId": "17c5d0e0-8992-4be7-864a-f7d2c38f51ee",
  "title": "Missing Parameter",
  "type": "https://staid-approach.com"
}
{
  "title": "No credentials provided",
  "type": "https://optimal-spear.org/"
}
{
  "title": "Internal Server Error",
  "type": "https://wide-eyed-trench.info"
}
Service Homepage: developer.dhl.com/api-reference/duty-tax-dhl-ecommerce-americas#reference-docs-section
dhllogisticsshippingquotesecommercerest