API Docs
Home
Home
Developer GuideAPI
StatusWebhooks
Developer GuideAPI
StatusWebhooks
  1. Options
  • Config
    • List Pickup Address
      GET
    • List Box Dimension
      GET
    • List vendor
      GET
    • List store
      GET
  • Online Product
    • Options
      • List category
        GET
      • List brand
        GET
    • Create Single Product
      POST
    • Create Product From Product Inventory
      POST
    • List product
      GET
    • Product detail
      GET
  • Product Inventory
    • Options
      • List Outbound Strategy
      • List Product Type
      • List Material
      • List Storage Method
    • List product inventory
      GET
    • Product inventory detail
      GET
    • Create single inventory product
      POST
  • Order
    • Shipping Service
      • Preview shipping prices
        • List shipping service
        • List available courier
      • List available courier from order
      • List shipping service of courier
    • Create order B2C
      POST
    • Create order B2B
      POST
    • List order
      GET
    • Order detail
      GET
    • Cancel order
      PATCH
  • Shipment
    • Create shipment auto
      POST
    • [Retail][Ship by self] Create shipment with item
      POST
    • Cancel shipment
      PATCH
    • List shipment
      GET
    • Shipment detail
      GET
    • List shipment of order
      GET
  • Shipment Inbound
    • Create shipment inbound
    • Cancel shipment inbound
    • List shipment inbound
    • Shipment inbound detail
    • Shipment inbound items
  • Order Return
    • List return order
    • Return order detail
    • Create return order
    • Cancel Return Order
  • Courier
    • List courier service integrated
    • List courier operate
    • List courier integrated
  • Address Directory
    • Province
    • District
    • Ward
  1. Options

List category

GET
/api/v1/public/products/category/list
This API is used to retrieve a list of product categories. These categories are used to organize and classify products for easier browsing and searching.

Response Format#

data (array): List of product category objects. Each object contains:
id (integer): Unique identifier of the category.
name (string): Name of the category (e.g., "Watches", "Du lịch").
list_id (array): The full hierarchical path of the category, represented as a list of category objects:
Each object includes:
id: ID of the category.
name: Name of the category.
parent_id: ID of the parent category (null if it's a root category).
child (array): A list of subcategories, each following the same structure as the parent.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/public/products/category/list' \
--header 'Authorization;'
Response Response Example
{
    "status_code": 200,
    "data": [
        {
            "id": 2477,
            "name": "Khác",
            "list_id": [
                {
                    "id": 2477,
                    "name": "Khác",
                    "parent_id": null
                }
            ],
            "child": []
        },
        {
            "id": 2472,
            "name": "Watches",
            "list_id": [
                {
                    "id": 2472,
                    "name": "Watches",
                    "parent_id": null
                }
            ],
            "child": []
        },
        {
            "id": 2461,
            "name": "Du lịch",
            "list_id": [
                {
                    "id": 2461,
                    "name": "Du lịch",
                    "parent_id": null
                }
            ],
            "child": [
                {
                    "id": 2462,
                    "name": "Đồ dùng du lịch",
                    "parent_id": 2461,
                    "list_id": [
                        {
                            "id": 2461,
                            "name": "Du lịch",
                            "parent_id": null
                        },
                        {
                            "id": 2462,
                            "name": "Đồ dùng du lịch",
                            "parent_id": 2461
                        }
                    ],
                    "child": [
                        {
                            "id": 2471,
                            "name": "Vali du lịch",
                            "parent_id": 2462,
                            "list_id": [
                                {
                                    "id": 2461,
                                    "name": "Du lịch",
                                    "parent_id": null
                                },
                                {
                                    "id": 2462,
                                    "name": "Đồ dùng du lịch",
                                    "parent_id": 2461
                                },
                                {
                                    "id": 2471,
                                    "name": "Vali du lịch",
                                    "parent_id": 2462
                                }
                            ],
                            "child": [
                                {
                                    "id": 2473,
                                    "name": "Vali du lịch - test",
                                    "parent_id": 2471,
                                    "list_id": [
                                        {
                                            "id": 2461,
                                            "name": "Du lịch",
                                            "parent_id": null
                                        },
                                        {
                                            "id": 2462,
                                            "name": "Đồ dùng du lịch",
                                            "parent_id": 2461
                                        },
                                        {
                                            "id": 2471,
                                            "name": "Vali du lịch",
                                            "parent_id": 2462
                                        },
                                        {
                                            "id": 2473,
                                            "name": "Vali du lịch - test",
                                            "parent_id": 2471
                                        }
                                    ],
                                    "child": []
                                }
                            ]
                        },
                        {
                            "id": 2470,
                            "name": "Túi du lịch và dây đeo túi",
                            "parent_id": 2462,
                            "list_id": [
                                {
                                    "id": 2461,
                                    "name": "Du lịch",
                                    "parent_id": null
                                },
                                {
                                    "id": 2462,
                                    "name": "Đồ dùng du lịch",
                                    "parent_id": 2461
                                },
                                {
                                    "id": 2470,
                                    "name": "Túi du lịch và dây đeo túi",
                                    "parent_id": 2462
                    

Request

Header Params
Authorization
string 
required
Default:
{{your_api_key_here}}

Responses

🟢200OK
application/json
Body
status_code
integer 
optional
data
array [object {4}] 
optional
id
integer 
optional
name
string 
optional
list_id
array [object {3}] 
optional
child
array [object {5}] 
optional
error
boolean 
optional
error_code
string 
optional
log_id
string 
optional
messages
string 
optional
total
integer 
optional
Previous
List store
Next
List brand
Built with