--- title: "Commodity Codes Validation" method: POST path: "/v4/GetCommodityCodeValidations" tags: ["Hurricane Services"] --- # Commodity Codes Validation `POST /v4/GetCommodityCodeValidations` Validate the Harmonized System (HS) codes for items being shipped.
This API helps ensure that the HS codes provided for items accurately correspond to the descriptions and comply with customs requirements, providing improved quality of customs data provided for international shipments. ## Request body - CommodityCodeValidationRequest — Commodity Code Validation Request - `ShippingAccountId` string, nullable — A unique identifier for the shipping account, which can either be generated by the system or provided by you (alias) during shipping account creation.
This ID helps associate the request with a specific shipping account. - `Shipment` CommodityCodeValidationRequestShipment, required — The shipment subjected to the commodity code validation, allowing the user to provide details about the entire shipment for validation - `Reference` string, nullable — A reference string that is used to trace the response of the request.
This allows users to keep track of their requests and facilitates easier follow-up if needed. - `ShipperCountryCode` string, required — An abbreviation representing the shipment origin country, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom. - `DestinationCountryCode` string, required — An abbreviation representing the destination country, following the ISO 3166-1 alpha-2 standard, for example, "US" for the United States of America. - `UseDescription` boolean, nullable — A boolean value indicating whether the item description in the request should be used to validate the HS code when there is a mismatch.
If set to true, the provided description will be utilized; if false, the item description will be ignored.

Enum [true, false] - `Items` CommodityCodeValidationRequestItem[], required — A collection of items for which the user wants to validate their HS codes, allowing for multiple items to be checked in a single request.

Before sending the request, make sure of the following conditions:
Note: For better performance, it is recommended to send 10 items or less in a single request. - `SkuCode` string, nullable — A unique Stock Keeping Unit (SKU) code assigned to the item. This code is essential for tracking inventory, helping users identify specific items easily. - `HSCode` string, nullable — The Harmonized System (HS) code used by customs to determine potential duties and taxes for the product.
This code can be 6, 8, or 13 alphanumeric characters, depending on specific services or destinations.
Some countries may use HS codes with different character lengths, such as 10 or 12 characters.

Note: The HS Code or Description must be provided. If both are supplied, and they do not match for the same product, then only the HSCode will take precedence.
Characters like space and dot are supported.

For more information on HS Codes see https://www.gov.uk/trade-tariff - `Description` string, nullable — A detailed description of the item being shipped, which helps verify that the HS code provided is appropriate for the nature of the item.

Note: The HS Code or Description must be provided. If both are supplied, and they do not match for the same product, then only the HSCode will take precedence.
Characters like space and dot are supported. ## Response `200` Returns commodity code validation response. - CommodityCodeValidationResponse — Commodity Code Validation Response - `ShippingAccountId` string, nullable — The unique identifier for the shipping account used in the request, returned for confirmation of the matched account.

Note: If an empty value was sent in the request, then this field will return as blank. - `Shipment` CommodityCodeValidationResponseShipment — The shipment object returned in the response, reflecting the processed shipment details. - `Reference` string, nullable — A reference string that is used to trace the response of the request. This allows users to keep track of their requests and facilitates easier follow-up if needed.

Note: If an empty value was sent in the request, then this field will return as blank. - `Items` CommodityCodeValidationResponseItem[], nullable — An array of items validated in the request, returned with their respective validation results - `HSCode` string, nullable — The HS code for each item as provided in the request, confirming the original code submitted for validation.

Note: If an empty value was sent in the request, then this field will return as blank. - `HS6Code` string, nullable — The trimmed down 6-digit HS code used by Hurricane for classification, reflecting the higher-level categorisation of the item.

Note: If an empty value was sent in the request, then this field will return as blank. - `Description` string, nullable — The description of each item as provided in the request, confirming the information submitted for validation.

Note: If an empty value was sent in the request, then this field will return as blank. - `10DigitExportCode` string, nullable — The most likely 10-digit HS code that should be used for exporting the item from the source country, reflecting required customs codes. - `10DigitImportCode` string, nullable — The most likely 10-digit HS code to be followed for importing the item into the destination country, which is essential for compliance with import regulations - `SuitableDescription` string, nullable — A description deemed appropriate for the supplied HS code for validation, providing guidance on what description should be used for customs documentation.

Note: This description may be generic and may not match the provided description. - `IsError` boolean — A boolean indicating whether an error occurred during the request processing. It helps users quickly identify if there was an issue with their request.

Note: If an error has been returned by Hurricane, then the information about the error will be provided in the ErrorDescription field. - `ErrorDescription` string, nullable — A description of the error during the request (if encountered), providing insights into what went wrong and how it can be addressed. - `OriginalImportCode` string, nullable — The original length version of the 10DigitImportCode. If the HS code matched to the item is longer or shorter than 10 digits, it will be trimmed or padded in the 10DigitImportCode field. This field contains the original HS code without any trimming or padding.

Note: The HS code returned in this field may still be 10 digits, the length will depend on the country and the tariff. - `OriginalExportCode` string, nullable — The original length version of the 10DigitExportCode. If the HS code matched to the item is longer or shorter than 10 digits, it will be trimmed or padded in the 10DigitExportCode field. This field contains the original HS code without any trimming or padding.

Note: The HS code returned in this field may still be 10 digits, the length will depend on the country and the tariff. - `GeneratedDate` string, nullable — A timestamp in Coordinated Universal Time (UTC) returned by Hurricane, indicating when the call was performed, aiding in tracking and logging activities. ## Other responses - `400` — Invalid request response. - `401` — Unauthorized - `403` — Forbidden - `500` — Internal Server Error --- [API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)