---
title: "List attributes"
method: GET
path: "/v1/attributes"
tags: ["attributes"]
---

# List attributes

`GET /v1/attributes`

To work with attributes, we distinguish between __attribute groups__ and __attribute values__:
* Each product can be assigned to many __attribute values__, for example: `white` or `M`.
* Each attribute belongs to exactly one __attribute group__, for example: `color` or `size`.

When generally talking about attributes, both [attribute groups](/en/user-guide/settings/product-structure/attributes) and attribute values are sometimes referred to as just __attributes__. To avoid confusion when addressing technical details, use the more specific terms __attribute groups__ and __attribute values__.

You can use `/attributes` to retrieve all your attribute groups. To get only a few attribute groups, you can specify their attribute group IDs or their attribute group names.
You can also get individual attribute groups and their attribute values with `/v1/attributes/{attributeGroupName}`.

## Query parameters

- `names` string[]
- `ids` integer[]
- `with` string[]
- `shopId` string, required

## Response `200`

successful operation

- Attribute[]
  - `id` integer, required
  - `key` string, required — Reference that identifies the attribute
  - `label` string, required — The label that describes the attribute group will be set according to the shop's language in the SCAYLE Panel.
  - `multiSelect` boolean, required — A flag which determines whether an attribute has a single or possibly multiple values.
  - `type` string, required — Attribute type
  - `values` AttributeValue[], nullable — The values are a collection of attributes from the attribute group.
    - `id` integer
    - `label` string
    - `value` string

## Other responses

- `400` — Required query parameter missing / invalid
- `401` — Authentication information is missing or invalid
- `404` — The specified resource was not found

---

[API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)