LandedCost.io HS Codes API Documentation

The HS Code Search API returns an accurate country specific HS Code and top 5 HS Codes (optional) based on the product name, description and category information.

HS Code Search API Endpoint URL

https://api.landedcost.io/data/hsdocument/findAll

HS Codes API Request Method

POST

HS Codes API API Request Definitions

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

HS Codes API Response Definitions

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
topHSCodes The top HS Codes found based on the the product name, description and category details Yes Array of Strings 1 1..5

Sample HS Codes API JSON Request

 
{
 "description": "Cleto Reyes Boxing Gloves 12 ounces", 
 "hsCodeSearchAPISecurityKey":"{Your Security Key Goes Here}",
 "name":"boxing gloves", "numberOfTopHSCodesToReturn":"3",
 "category":"boxing",
 "destinationCountryCode":"PE",
 "sku": "1001"
}

Sample HS Code Search API JSON Response

      
{"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"}