List product categories

Returns all product categories defined for the company. Categories appear as a horizontal chip strip above the POS product grid; tapping one filters the grid to that category.

GET /api/v1/product-categories

Headers

NameTypeRequiredDescription
AuthorizationstringYesBearer token
X-CompanystringYesCompany UUID

Response

{
  "data": [
    { "id": "0a..f", "name": "Cafele", "color": "#7c3aed", "sortOrder": 0 },
    { "id": "1b..e", "name": "Sandwich-uri", "color": "#16a34a", "sortOrder": 1 }
  ]
}
FieldTypeDescription
idstringCategory UUID
namestringDisplay name (1–100 chars)
colorstring | nullOptional hex swatch (#RRGGBB) used for the chip and as Product card fallback
sortOrderintegerSort key (smaller = earlier)

Permissions

Requires product.view.