Category

List active categories with optional parent filtering

Returns a flat list of active categories only (status=1). Admin-disabled categories are never returned. Use ?parent_id=N for direct children of a category. Each item embeds its translation, children, and filterableAttributes. For a hierarchical tree response use /category-trees instead. Public endpoint.

get/categories

Request

Query parameters

parent_idinteger
Example:2

Return only direct children of this category ID. Accepts parentId as an alias.

pageinteger

Page number (1-based).

per_pageinteger

Items per page. Default 10, max 50.

Headers

X-STOREFRONT-KEYstring required

Storefront API Key for authentication. Required for all shop/storefront API requests.

X-Localestring
Example:en

Locale code for localized data (e.g. "en", "fr", "ar"). Defaults to channel's default locale.

X-Channelstring
Example:default

Channel code (e.g. "default"). Defaults to the current channel.

X-Currencystring
Example:USD

Currency code (e.g. "USD", "EUR", "INR"). Defaults to channel's base currency.

Response

List of active categories.

Changes

No recorded changes to this operation across all 13 revisions of this API.