Get Categories - Venddor API

GET {{baseUrl}}/Categories/

This endpoint retrieves all product categories available in the marketplace.

Request Headers

Header	Value	Description
Authorization	Basic Auth	Base64 encoded username:password combination

Response

The endpoint returns a list of all categories with their details.

Example Response

[
  {
    "category_id": "1384",
    "category": "Footwear",
    "parent_id": "0",
    "category_path": "Footwear",
    "id_path": "1384",
    "status": "A",
    "product_count": 245
  },
  {
    "category_id": "1447",
    "category": "Clothing",
    "parent_id": "0",
    "category_path": "Clothing",
    "id_path": "1447",
    "status": "A",
    "product_count": 378
  },
  {
    "category_id": "1459",
    "category": "Accessories",
    "parent_id": "0",
    "category_path": "Accessories",
    "id_path": "1459",
    "status": "A",
    "product_count": 156
  },
  {
    "category_id": "1792",
    "category": "Kids",
    "parent_id": "1384",
    "category_path": "Footwear/Kids",
    "id_path": "1384/1792",
    "status": "A",
    "product_count": 82
  }
]

Category Response Fields

Field	Type	Description
category_id	string	Unique identifier for the category
category	string	Name of the category
parent_id	string	ID of the parent category (0 if this is a top-level category)
category_path	string	Full path of the category hierarchy
id_path	string	Full path of the category IDs
status	string	Category status: `"A"` for active, `"D"` for disabled
product_count	number	Number of products in this category

Tip: Categories can have a hierarchical structure. Top-level categories have parent_id set to "0". Subcategories have the parent_id set to the ID of their parent category.