Get HSCode Categories

Fetch list of HS Code Categories for a specific chapter

/hs-codes/category

GET https://api.terminal.africa/v1/hs-codes/category

This endpoint allows you to get a list of available hs code categories for a given chapter.

Query Parameters

Name	Type	Description
chapter	String	HS Chapter code. If not provided, all available categories are returned.

Headers

Name	Type	Description
Authorization*	String	Set value to Bearer SECRET_KEY

200 Hs code categories retrieved successfully

{
    "status": true,
    "message": "Hs codes categories retrieved successfully",
    "data": [
        {
            "_id": "3306",
            "category": "Preparations for oral or dental hygiene, incl. denture fixative pastes and powders; yarn used to clean between the teeth \"dental floss\", in individual retail packages",
            "category_code_count": 3
        },
        {
            "_id": "3307",
            "category": "Shaving preparations, incl. pre-shave and aftershave products, personal deodorants, bath and shower preparations, depilatories and other perfumery, toilet or cosmetic preparations, n.e.s.; prepared room deodorisers, whether or not perfumed or having disinfectant properties",
            "category_code_count": 6
        },
        {
            "_id": "3305",
            "category": "Preparations for use on the hair",
            "category_code_count": 4
        },
        {
            "_id": "3301",
            "category": "Essential oils, whether or not terpeneless, incl. concretes and absolutes; resinoids; extracted oleoresins; concentrates of essential oils in fats, fixed oils, waxes or the like, obtained by enfleurage or maceration; terpenic by-products of the deterpenation of essential oils; aqueous distillates and aqueous solutions of essential oils",
            "category_code_count": 29
        },
        {
            "_id": "3302",
            "category": "Mixtures of odoriferous substances and mixtures, incl. alcoholic solutions, based on one or more of these substances, of a kind used as raw materials in industry; other preparations based on odoriferous substances, of a kind used for the manufacture of beverages",
            "category_code_count": 9
        },
        {
            "_id": "3303",
            "category": "Perfumes and toilet waters",
            "category_code_count": 3
        },
        {
            "_id": "3304",
            "category": "Beauty or make-up preparations and preparations for the care of the skin, incl. sunscreen or suntan preparations (excl. medicaments); manicure or pedicure preparations",
            "category_code_count": 5
        }
    ]
}