GET /taxonomy/attributes/{handle}/values lists the canonical values of one attribute, such as neckline__halter for neckline. To filter search by a value, send {"name": attribute.facetName, "values": [value.handle]} in facets on POST /products/search.
These are canonical definitions, not inventory. A value listed here may match no product in your catalog scope. Use
POST /products/facet-counts with attributes to list only values that have products, with counts./v1 route.
Request
Path parameters
Attribute handle from
GET /taxonomy/attributes, such as neckline.Query parameters
Response
The attribute, in the shape
GET /taxonomy/attributes returns. Its facetName is the facet to send the value handles under.Offset of the next page. Repeat the request with it as
offset. null on the last page.Example response
GET /taxonomy/categories with the attribute facet:
Errors
See the overview for authentication and rate-limit errors.
Operation ID:
listTaxonomyAttributeValues. SDK methods: Python list_taxonomy_attribute_values(handle, offset=..., limit=...); TypeScript listTaxonomyAttributeValues(handle, { offset, limit }). The MCP equivalent is taxonomy_attribute.