The HS Code Search API returns an accurate country-specific HS Code based on the destination country code, product name, description and category information.
https://api.landedcost.io/hscodesearch
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 |
Name | Description | Required | Type | Max Allowed | Length | Validation Rules |
---|---|---|---|---|---|---|
id | Unique identifier generated by each HS Codes 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 |
{ "description": "Cleto Reyes Boxing Gloves 12 ounces", "hsCodeSearchAPISecurityKey":"{Your Security Key Goes Here}", "name":"reyes boxing gloves", "category":"boxing","sku": "1000", "destinationCountryCode":"US" }
{"id":"5bd3aee92a3e3f472efaa773", "description":"Cleto Reyes Boxing Gloves 12 ounces", "hsCode":"420321", "hsCodeSearchAPISecurityKey":"{Your Security Key}", "category":"boxing", "sku":"1000", "name":"reyes boxing gloves", "destinationCountryCode":"US", "utcDateTimeStamp":"Sat, Oct 20, 2018 12:18:49 AM UTC"}