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.
Request
- Base URLhttp://localhost:8000/api/shop
- AuthHTTP bearer
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
Return only direct children of this category ID. Accepts parentId as an alias.
Page number (1-based).
Items per page. Default 10, max 50.
Headers
Storefront API Key for authentication. Required for all shop/storefront API requests.
Locale code for localized data (e.g. "en", "fr", "ar"). Defaults to channel's default locale.
Channel code (e.g. "default"). Defaults to the current channel.
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.