FleetbaseFleetbase

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 for a store key, network categories for a network key, or product categories for a selected network member store. Category and product expansion remains scoped to the authenticated storefront owner.

Query parameters
storestringoptional

Network member store public ID whose product categories should be returned.

parentstringoptional

Parent category public ID used to return its direct children.

parents_onlybooleanoptional

Return only top-level categories.

with_productsbooleanoptional

Include published, available products for each returned store product category.

with_storesbooleanoptional

For network categories, include member stores assigned to each category.

GET/v1/categories
curl https://api.fleetbase.io/v1/categories?store=&parent=&parents_only=&with_products=&with_stores= \
  -H "Authorization: Bearer flb_live_…"
Category | Fleetbase