HS Code Search API

Estimated reading: 2 minutes 16 views

HS Code Search API Documentation

The HS Code Search API returns a country specific HS Code based on the product name, description and category information.

HS Code Search API Endpoint URL

api.landedcost.io/data/hsdocument/findAll

HS Code Search API Request Method

POST

HS Code Search API Request Definitions

NameDescriptionRequiredTypeMax AllowedLength
hsCodeSearchAPISecurityKeyThe seller’s HS Code API security keyYesString11…100
skuThe product unique identifierYesString11…50
nameThe product title (primary product name)YesString11…100
categoryThe product categoryYesString11…100
descriptionThe product descriptionYesString11…500
destinationCountryCodeThe destination’s two-digit ISO country codeYesString12
numberOfTopHSCodesToReturnThe number of top HS Codes to return. Numbers between 1 and 5 are only allowedNoString11

HS Code Search API Response Definitions

NameDescriptionRequiredTypeMax AllowedLengthValidation Rules
idUnique identifier generated by each HS Code Search API call. This id can be used for reference during reconciliation or integration.YesString113
hscodeThe HS Code number returned from the product name, description and category analysis. If no HS Code could be determined, 000000 will be returned.YesString16..12
skuThe product sku used in the searchYesString11…500
nameThe product name used in the searchYesString11…100
categoryThe product category used in the searchYesString11…100
descriptionThe product description used in the searchYesString11…500
securityKeyThe seller’s API security keyYesString11…100
destinationCountryCodeThe destination’s two-digit ISO country codeYesString12
utcDateTimeStampThe API response date/timeStamp in Coordinated Universal Time (UTC)YesString11..100
topHSCodesThe top HS Codes found based on the the product name, description and category detailsYesArray of Strings11..5

Sample HS Code Search 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"}

Leave a Reply

Your email address will not be published. Required fields are marked *

Share this Doc

HS Code Search API

Or copy link

CONTENTS