Get HS Code for Single Country

Returns the full-length HS/HTS tariff code for a single item to a given destination country.Pre-classify products or obtain tariff codes when needed for crossborder transactions from AI models, facilitating customs formalities and the accurate calculation of import charges.

SecuritybearerAuth
Request
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
destinationCountryCode
string [ 2 .. 3 ] characters

The country to which the shipment is intended. This must be a valid ISO 3166-1 alpha-2 or alpha-3 country code (e.g., US or USA).

  • The field is required only if retrieving a country-specific HS code.
  • If not provided, a non-country-specific HS6 (international) code will be returned.
pricingCurrencyCode
string = 3 characters

The currency used for the item price. It must be a valid ISO 4217 currency code (e.g., USD, EUR).

  • This field is required only if the item price is provided.
required
object

Details of the item to be classified.

Responses
200

The requested HS Code 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/hsclassification
Request samples
application/json
{
  • "destinationCountryCode": "CA",
  • "pricingCurrencyCode": "USD",
  • "item": {
    }
}
Response samples
application/json
{
  • "item": {
    }
}