LandedCost.io HS Codes API Documentation

The HS Code Search API returns a accurate (6-digit) HS Code based on the 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
securityKey The seller's API security key Yes String 1 1...100
sku The product description Yes String 1 1...50
name The 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

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 associated with the search Yes String 1 6
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
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", "securityKey":"{Your Security Key Goes Here}",
    "name":"reyes boxing gloves", "category":"boxing","sku": "1000"
}

Sample HS Code Search API JSON Response

 
{"id":"5bd3aee92a3e3f472efaa773",
"description":"Cleto Reyes Boxing Gloves 12 ounces",
"hsCode":"420321",
"securityKey":"{Your Security Key}",
"category":"boxing",
"sku":"1000",
"name":"reyes boxing gloves",
"utcDateTimeStamp":"Sat, Oct 20, 2018 12:18:49 AM UTC"}