📂 Categories
Items. It uses a parent_id to create a hierarchical tree structure.Fields
| Name | Type | Description |
|---|---|---|
id | string | The unique identifier for the category. |
name | string | The display name of the category. |
description | string | Optional. A brief description of the category's contents. |
parent_id | string | The id of the parent category. null for top-level categories. |
is_active | boolean | A flag to enable or disable the category. |
updated_at | string | The timestamp of the last modification (ISO 8601 UTC). |
Sample JSON
Grocery Hierarchy Example
// Top Level
{
"id": "cat_groceries",
"name": "Groceries",
"description": "All fresh and packaged food items.",
"parent_id": null,
"is_active": true,
"updated_at": "2025-07-01T10:00:00Z"
}
// Level 2
{
"id": "cat_dairy_eggs",
"name": "Dairy & Eggs",
"description": "Includes milk, cheese, yogurt, and eggs.",
"parent_id": "cat_groceries",
"is_active": true,
"updated_at": "2025-07-01T10:05:00Z"
}
// Level 3
{
"id": "cat_milk",
"name": "Milk",
"description": "Fresh, long-life, and flavored milk.",
"parent_id": "cat_dairy_eggs",
"is_active": true,
"updated_at": "2025-07-01T10:10:00Z"
}Restaurant Menu Hierarchy Example
// Top Level (Restaurant Menu)
{
"id": "cat_rbh_menu",
"name": "Riyadh Burger House Menu",
"description": "Our signature burgers, sides, and drinks.",
"parent_id": null,
"is_active": true,
"updated_at": "2025-10-15T09:00:00Z"
}
// Level 2 (Menu Section)
{
"id": "cat_burgers",
"name": "Signature Burgers",
"description": "All our handcrafted burgers.",
"parent_id": "cat_rbh_menu",
"is_active": true,
"updated_at": "2025-10-15T09:05:00Z"
}