GET /taxonomy/attributes lists the attributes that enrichment records for products in one category, such as neckline, fabric, and sleeve_style for dresses. Each attribute includes its facetName, the name to filter on in POST /products/search facets.
Read an attribute’s values with GET /taxonomy/attributes/{handle}/values.
These are canonical definitions, not inventory. An attribute listed here may be populated on few products in your catalog scope. Use
POST /products/facet-counts to count products by attribute value./v1 route.
Request
Query parameters
The category whose attributes to list. Accepts a category UUID, a section handle such as
apparel, or a category path such as Apparel & Accessories > Clothing > Dresses in any letter case. See GET /taxonomy/categories.Response
The requested category, in the shape
GET /taxonomy/categories returns.Offset of the next page. Repeat the request with it as
offset. null on the last page.Example response
Errors
See the overview for authentication and rate-limit errors.
Operation ID:
listTaxonomyAttributes. SDK methods: Python list_taxonomy_attributes(category, offset=..., limit=...); TypeScript listTaxonomyAttributes(category, { offset, limit }). The MCP equivalent is the attribute_handles on each taxonomy_tree node.