FleetbaseFleetbase
Start Free Trial

Category

Categories organize storefront products for browsing and discovery. Use category endpoints to list product groupings exposed by a store or network.

The Category object

A category groups storefront products and can include nested subcategories.
Attributes
idstringoptional

Public identifier of the category.

namestringoptional

Category name.

descriptionstringoptional

Category description.

icon_urlstringoptional

Category icon URL.

parentstringoptional

Parent category public ID when loaded.

tagsarray of stringsoptional

Category tags.

translationsobjectoptional

Translated category values.

productsarray of objectsoptional

Products in the category when requested.

subcategoriesarray of objectsoptional

Nested subcategories when requested.

metaobjectoptional

Arbitrary metadata stored with the category.

orderintegeroptional

Sort order.

slugstringoptional

URL-friendly category slug.

created_attimestampoptional

Time the category was created.

updated_attimestampoptional

Time the category was last updated.

The Category object
{
  "id": "category_2xK9mP1",
  "name": "Beverages",
  "description": "Drinks and bottled beverages.",
  "icon_url": "https://files.example.com/beverages.png",
  "parent": null,
  "tags": [],
  "translations": [],
  "meta": {},
  "order": 1,
  "slug": "beverages",
  "created_at": "2026-05-07T09:30:00Z",
  "updated_at": "2026-05-07T09:30:00Z"
}
GET/v1/categories

List categories

Returns product categories available to the current storefront. Use this list to organize product browsing and filtering.

GET/v1/categories
curl https://api.fleetbase.io/v1/categories \
  -H "Authorization: Bearer flb_live_…"
Category | Fleetbase