Skip to main content
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.
This endpoint is not billed. It is rate limited like every /v1 route.

Request

Query parameters

string
required
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.
integer
default:"0"
Number of attributes to skip. Use the previous page’s nextOffset.
integer
default:"50"
Attributes per page, from 1 to 100.

Response

string
required
Canonical taxonomy version name, such as v4.
TaxonomyCategory
required
The requested category, in the shape GET /taxonomy/categories returns.
TaxonomyAttribute[]
required
This page of attributes.
integer
required
Number of attributes across all pages.
integer | null
required
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.