International HsCode

The HS Code, or Harmonized System Code, is a globally standardized numerical code used to identify goods for customs purposes. It streamlines trade by providing a unique identifier for products.

To retrieve the HS Code for your international shipment payload, particularly within the items object, follow these two steps:

1. Call the Chapters endpoint to obtain a preliminary categorization of the goods.

2. Use the response from the Chapters endpoint to call the Categories endpoint, from which you can retrieve the specific HS Code.

HsCode Request

1. Get Chapters Request

Curl

curl --location 'https://delivery-staging.apiideraos.com/api/v2/token/hscode/chapters' \
--header 'Authorization: Bearer Secret Key'

Python

Ruby

PHP

Javascript

Golang

Get Chapters Response

200

{
    "data": [
        "Fertilizers",
        "Manufactures of Straw, of Esparto or of Other Plaiting Materials; Basketware and Wickerwork",
        "Pulp of Wood or of Other Fibrous Cellulosic Material; Recovered (Waste and Scrap) Paper or Paperboard",
        "Paper and Paperboard; Articles of Paper Pulp, of Paper or of Paperboard",
        "Printed Books, Newspapers, Pictures and Other Products of the Printing Industry; Manuscripts, Typescripts, and Plans",
        "Silk",
        "Articles of Apparel and Clothing Accessories, Knitted or Crocheted",
        "Articles of Apparel and Clothing Accessories, Not Knitted or Crocheted",
        "Other Made-Up Textile Articles; Sets; Worn Clothing and Worn Textile Articles; Rags",
        "Footwear, Gaiters, and the Like; Parts of Such Articles",
        "Headgear and Parts Thereof",
        "Umbrellas, Sun Umbrellas, Walking-Sticks, Seat-Sticks, Whips, Riding-Crops, and Parts Thereof",
        "Prepared Feathers and Down and Articles Made of Feathers or of Down; Artificial Flowers; Articles of Human Hair"
    ],
    "status": true,
    "message": "Chapters retrieved",
    "status_code": 200
}

404

2. Get Categories Request

chapter_id is the name of the chapter selected above.

Curl

curl --location 'https://delivery-staging.apiideraos.com/api/v2/token/hscode/categories?chapter_id=Fertilizers' \
--header 'Authorization: Bearer Secret Key'

Python

Ruby

PHP

Javascript

Golang

Get Categories Response

404

{
    "status": false,
    "message": "Invalid route or endpoint not found",
    "status_code": 404
}

200

422

Choose any category from the response, and include it in the items payload when booking international shipments.