Categories
The Categories API exposes both the business category tree (3-level: Sector → Group → Category) and product-specific categories.
All category endpoints require the categories.read permission scope.
Available Endpoints
GET
/v1/categoriesFull business category tree
categories.read
GET
/v1/categories/:idSingle category with parent chain
categories.read
GET
/v1/product-categoriesProduct-specific categories
categories.read
Category Tree Structure
The business category tree has 3 levels of depth:
| Depth | Level | Example |
|---|---|---|
| 0 | Sector | Manufacturing |
| 1 | Group | Furniture & Woodwork |
| 2 | Category | Office Furniture |
Response Example
{
"data": [
{
"id": "uuid",
"name": "Manufacturing",
"slug": "manufacturing",
"depth": 0,
"parent_id": null,
"children": [
{
"id": "uuid",
"name": "Furniture & Woodwork",
"slug": "furniture-woodwork",
"depth": 1,
"children": [
{
"id": "uuid",
"name": "Office Furniture",
"slug": "office-furniture",
"depth": 2
}
]
}
]
}
]
}Last updated on February 23, 2026