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

Request

Path parameters

string
required
Attribute handle from GET /taxonomy/attributes, such as neckline.

Query parameters

integer
default:"0"
Number of values to skip. Use the previous page’s nextOffset.
integer
default:"50"
Values per page, from 1 to 100.

Response

string
required
Canonical taxonomy version name, such as v4.
TaxonomyAttribute
required
The attribute, in the shape GET /taxonomy/attributes returns. Its facetName is the facet to send the value handles under.
TaxonomyAttributeValue[]
required
This page of values.
integer
required
Number of values 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

To find boat-neck dresses, combine the category facets from 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.