> ## Documentation Index
> Fetch the complete documentation index at: https://storerouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /taxonomy/attributes — list a category's attributes

> List the enrichment attributes a taxonomy category carries, such as neckline for dresses, with the search facet name for each.

`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`](https://storerouter.ai/docs/api-reference/search-products) `facets`.

Read an attribute's values with [`GET /taxonomy/attributes/{handle}/values`](https://storerouter.ai/docs/api-reference/list-taxonomy-attribute-values).

> [!NOTE]
>
> 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`](https://storerouter.ai/docs/api-reference/count-product-facets) to count products by attribute value.

This endpoint is not billed. It is rate limited like every `/v1` route.

## Request

```bash theme={null}
curl "https://api.storerouter.ai/v1/taxonomy/attributes?category=apparel%20%26%20accessories%20%3E%20clothing%20%3E%20dresses&limit=2" \
  -H "Authorization: Bearer $STOREROUTER_API_KEY"
```

### Query parameters

**category** `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`](https://storerouter.ai/docs/api-reference/list-taxonomy-categories).

**offset** `integer` (default: 0)

Number of attributes to skip. Use the previous page's `nextOffset`.

**limit** `integer` (default: 50)

Attributes per page, from 1 to 100.

## Response

**taxonomyVersion** `string` *required*

Canonical taxonomy version name, such as `v4`.

**category** `TaxonomyCategory` *required*

The requested category, in the shape [`GET /taxonomy/categories`](https://storerouter.ai/docs/api-reference/list-taxonomy-categories#response) returns.

**attributes** `TaxonomyAttribute[]` *required*

This page of attributes.

**TaxonomyAttribute properties**

**handle** `string` *required*

Canonical attribute handle, such as `neckline`.

**name** `string` *required*

Display name, such as `Neckline`.

**description** `string | null`

What the attribute describes.

**facetName** `string | null` *required*

The search facet name for this attribute. Send its value handles under this name in `facets`. `null` when the attribute is not filterable.

**matching** `string | null` *required*

How a facet on this attribute matches. `null` when the attribute is not filterable.

**valueCount** `integer` *required*

Number of canonical values.

**total** `integer` *required*

Number of attributes across all pages.

**nextOffset** `integer | null` *required*

Offset of the next page. Repeat the request with it as `offset`. `null` on the last page.

### Example response

```json theme={null}
{
  "taxonomyVersion": "v4",
  "category": {
    "id": "8866aef9-1915-4d6e-b465-87ba30b50380",
    "name": "Dresses",
    "path": "Apparel & Accessories > Clothing > Dresses",
    "depth": 2,
    "childCount": 0,
    "facets": [
      {"name": "category_path.depth_0", "values": ["apparel & accessories"]},
      {"name": "category_path.depth_1", "values": ["clothing"]},
      {"name": "category_path.depth_2", "values": ["dresses"]}
    ]
  },
  "attributes": [
    {
      "handle": "baby_unique_features",
      "name": "Baby & Toddler Features",
      "description": "Features specific to baby and toddler clothing for safety and convenience",
      "facetName": "baby_unique_features",
      "matching": "any selected value; exact canonical handles",
      "valueCount": 5
    },
    {
      "handle": "construction_detail",
      "name": "Construction Detail",
      "description": "Describes fabric manipulation techniques used in garment construction, such as pleating or ruching.",
      "facetName": "construction_detail",
      "matching": "any selected value; exact canonical handles",
      "valueCount": 7
    }
  ],
  "total": 23,
  "nextOffset": 2
}
```

## Errors

| Status | `detail` | Cause |
| - | - | - |
| `404` | `taxonomy_category_not_found` | `category` names no category. |
| `422` | Validation array | `category` is missing or blank, or `offset` or `limit` is out of range. |

See the [overview](https://storerouter.ai/docs/api-reference/overview.md#error-model) 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`](https://storerouter.ai/docs/mcp/overview#taxonomy-discovery-tools) node.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.