Catalog Category — Detail

Returns a single category record by ID, including the full translations array (every locale present in the database) and the list of filterable attribute IDs configured for the category.

This is the read endpoint to call when an admin needs the complete metadata for a category — e.g. when opening the edit form in the Catalog → Categories UI.

Endpoint

Endpoint	Method	Authentication
/api/admin/catalog/categories/{id}	GET	Admin Bearer token

{id} must be a positive integer. Non-numeric values are rejected by a route requirement (\d+) — this prevents the {id} segment from matching the /tree path of the tree endpoint.

Path Parameter

Parameter	Type	Required	Description
id	integer	Yes	The numeric category ID

Response Shape

The response is a single JSON object (not wrapped in { data }) with the following fields:

Field	Type	Description
id	integer	Category ID
position	integer	Display order position
status	integer	1 = enabled, 0 = disabled
parentId	integer|null	Parent category ID; null for root nodes
displayMode	string|null	Category display mode (e.g. products_and_description)
logoUrl	string|null	Storage URL for the category logo; null if not set
bannerUrl	string|null	Storage URL for the category banner; null if not set
name	string|null	Category name in the current app locale
slug	string|null	URL slug in the current app locale
description	string|null	Category description in the current app locale
locale	string|null	App locale used for the top-level name/slug/description fields
createdAt	string|null	ISO 8601 creation timestamp
updatedAt	string|null	ISO 8601 last-update timestamp
translations	array	All locale translations (see below)
filterableAttributeIds	array|null	Integer IDs of attributes configured as filterable for this category

translations[] item shape

Each entry in the translations array corresponds to one locale row in category_translations:

Field	Type	Description
locale	string	Locale code (e.g. en, fr)
name	string|null	Category name in this locale
slug	string|null	URL slug in this locale
description	string|null	Description in this locale
metaTitle	string|null	SEO meta title in this locale
metaDescription	string|null	SEO meta description in this locale
metaKeywords	string|null	SEO meta keywords in this locale

Errors

HTTP	Detail
401	Unauthenticated.
404	{"type": "/errors/404", "title": "Not Found", "status": 404, "detail": "Category not found."}

A non-numeric {id} also returns 404. The route constrains the segment to digits, which is what keeps /catalog/categories/tree routing to the tree endpoint instead of being read as an id.

Working With This Endpoint

• translations carries one entry per stored locale row, not just the requested one, so a multi-locale store returns them all. Unset text fields come back as the empty string "", not null.
• The top-level name, slug, and description duplicate the requested locale's entry. They are a shortcut, not extra data — locale tells you which entry they came from.
• filterableAttributeIds is a flat integer array. [] means none are configured; it is the layered-navigation attribute set for this category, not the products' attributes.
• The response is a bare object, unlike the listing, which wraps rows in { data, meta }.