LandedCost.io HS Codes API Documentation

The HS Code Search API returns an accurate country-specific HS Code based on the destination country code, product name, description and category information.

HS Code Search API Endpoint URL

https://api.landedcost.io/hscodesearch

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

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

Sample HS Codes API JSON Request

 

{  
    "description": "Cleto Reyes Boxing Gloves 12 ounces", 
    "hsCodeSearchAPISecurityKey":"{Your Security Key Goes Here}",
    "name":"reyes boxing gloves", 
    "category":"boxing","sku": "1000",
     "destinationCountryCode":"US"
}

Sample HS Code Search API JSON Response

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