Calculate Duties and Taxes for Single Item Across Countries

This API calculates estimated duties and taxes duties for a single item across multiple destination countries. A landed cost is the total of all charges involved in a crossborder transaction, including transportation, import duties and taxes, shipping insurance, and related fees. Use this API to power a superior "duty-paid" checkout experience with accurate D&T estimates, and/or to inform business planning around import costs.

SecuritybearerAuth
Request
query Parameters
calculationType
string

The type of calculation to be performed. Possible values are:

  • duty: Only the duty will be returned
  • tax: Only the tax will be returned
  • duty_tax: Both duty and tax will be returned (default if not provided)
    Note: Duty and/or tax may still be calculated internally if required as part of determining the other, but the results will not be included in the response based on the calculation type.
Enum: "duty" "tax" "duty_tax"
Example: calculationType=duty_tax
header Parameters
X-PB-TransactionId
string

A unique Transaction ID provided by the partner, which is used to enable debugging and linking between the client's transaction and the system.Allowed characters limit is 36.

Content-Type
required
string

The media type of the request body.

Value: "application/json"
Request Body schema: application/json
exportCountryCode
required
string [ 2 .. 3 ] characters

The country from which the shipment is exported.

  • Must be a valid ISO 3166-1 alpha-2 or alpha-3 country code (e.g., US or USA).
serviceId
string

Shipping service type used. Customs processing and related fees can vary between courier shipments and parcels shipped and cleared via the International Postal System. For the most accurate duty and tax estimation, specify the service type related to your shipment

  • Valid values are COURIER and POSTAL.
  • If not provided, COURIER will be used as the default serviceId.
Enum: "COURIER" "POSTAL"
responseCurrencyCode
string = 3 characters

The currency in which the quote should be returned.

  • Must be a valid 3-character ISO 4217 currency code.
  • Defaults to USD if not provided.
pricingCurrencyCode
required
string = 3 characters

Currency code associated with the amounts passed in the request.

  • Must be a valid ISO 4217 currency code.
required
Array of objects
  • The countries to which the shipment is intended. This must be a valid ISO 3166-1 alpha-2 or alpha-3 country codes (e.g., US or USA).
  • The maximum number of countries can be pass in this array is 250 .
required
object

Details of the item used for duty and tax estimation.

Responses
200

The requested Landed Cost Quote has been retrived successfully.

400

Invalid request.

401

The request could not be authorized.

500

The request could not be completed due to an internal error.

post/api/v1/crossborder-services/landedCostQuote/bulk
Request samples
application/json
{
  • "exportCountryCode": "US",
  • "serviceId": "Courier",
  • "responseCurrencyCode": "USD",
  • "pricingCurrencyCode": "USD",
  • "destinationCountries": [
    ],
  • "item": {
    }
}
Response samples
application/json
{
  • "exportCountryCode": "US",
  • "serviceId": "Courier",
  • "responseCurrencyCode": "USD",
  • "item": {
    }
}