The HS Code Search API returns a country specific HS Code based on the product name, description and category information.
api.landedcost.io/data/hsdocument/findAll
POST
| Name | Description | Required | Type | Max Allowed | Length |
|---|---|---|---|---|---|
| hsCodeSearchAPISecurityKey | The seller's HS Code API security key | Yes | String | 1 | 1...100 |
| sku | The product unique identifier | Yes | String | 1 | 1...50 |
| name | The product title (primary product name) | Yes | String | 1 | 1...100 |
| category | The product category | Yes | String | 1 | 1...100 |
| description | The product description | Yes | String | 1 | 1...500 |
| destinationCountryCode | The destination's two-digit ISO country code | Yes | String | 1 | 2 |
| numberOfTopHSCodesToReturn | The number of top HS Codes to return. Numbers between 1 and 5 are only allowed | No | String | 1 | 1 |
| Name | Description | Required | Type | Max Allowed | Length | Validation Rules |
|---|---|---|---|---|---|---|
| id | Unique identifier generated by each HS Code Search API call. This id can be used for reference during reconciliation or integration. | Yes | String | 1 | 13 | |
| hscode | The HS Code number returned from the product name, description and category analysis. If no HS Code could be determined, 000000 will be returned. | Yes | String | 1 | 6..12 | |
| sku | The product sku used in the search | Yes | String | 1 | 1...500 | |
| name | The product name used in the search | Yes | String | 1 | 1...100 | |
| category | The product category used in the search | Yes | String | 1 | 1...100 | |
| description | The product description used in the search | Yes | String | 1 | 1...500 | |
| securityKey | The seller's API security key | Yes | String | 1 | 1...100 | |
| destinationCountryCode | The destination's two-digit ISO country code | Yes | String | 1 | 2 | |
| utcDateTimeStamp | The API response date/timeStamp in Coordinated Universal Time (UTC) | Yes | String | 1 | 1..100 | |
| topHSCodes | The top HS Codes found based on the the product name, description and category details | Yes | Array of Strings | 1 | 1..5 |
{
"description": "Cleto Reyes Boxing Gloves 12 ounces",
"hsCodeSearchAPISecurityKey":"{Your Security Key Goes Here}",
"name":"boxing gloves", "numberOfTopHSCodesToReturn":"3",
"category":"boxing",
"destinationCountryCode":"PE",
"sku": "1001"
}
{"id":"626ed17db399681c9af312dc",
"description":"Cleto Reyes Boxing Gloves 12 ounces",
"hsCode":"4203400000",
"category":"boxing",
"sku":"1001",
"name":"boxing gloves",
"utcDateTimeStamp":"Sun, May 1, 2022 06:29:17 PM UTC",
"hsCodeSearchAPISecurityKey":"{Your Security Key}",
"destinationCountryCode":"PE",
"topHSCodes":["6116100000",
"4203400000",
"4203400000"],"numberOfTopHSCodesToReturn":"3"}