Skip to main content
GET
/
admin
/
product-attributes
curl 'http://localhost:9000/admin/product-attributes?type=single_select&limit=20' \
  -H 'Authorization: Bearer <token>'

{
  "product_attributes": [
    {
      "id": "pattr_01HXYZABCDEF",
      "name": "Material",
      "handle": "material",
      "type": "single_select",
      "is_required": false,
      "is_filterable": true,
      "is_variant_axis": false,
      "is_active": true,
      "values": [
        { "id": "pattrval_01HXYZABCDEF", "name": "Linen", "rank": 0 }
      ]
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}
Returns global (non-product-scoped) attributes, with optional filtering by type, flags, and category.

​
Query parameters

​
limit
number
default:"50"
Maximum number of records to return.
​
offset
number
default:"0"
Number of records to skip.
​
order
string
Field to sort by, prefix with - for descending order.
​
fields
string
Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.
​
q
string
Search term matched against attribute fields.
​
id
string | string[]
Filter by attribute ID(s).
​
handle
string | string[]
Filter by attribute handle(s).
​
type
string | string[]
Filter by type: single_select, multi_select, unit, toggle, or text.
​
is_required
boolean
Filter by the required flag.
​
is_variant_axis
boolean
Filter by the variant-axis flag.
​
is_filterable
boolean
Filter by the filterable flag.
​
is_active
boolean
Filter by the active flag.
​
category_id
string | string[]
Filter to attributes linked to the given category(ies) or global to all categories.
​
created_at
object
Filter by creation date with operators like $gte, $lte.
​
updated_at
object
Filter by update date with operators like $gte, $lte.

​
Response

​
product_attributes
object[]
​
count
number
Total number of matching attributes.
​
offset
number
Number of records skipped.
​
limit
number
Number of records returned.
curl 'http://localhost:9000/admin/product-attributes?type=single_select&limit=20' \
  -H 'Authorization: Bearer <token>'

{
  "product_attributes": [
    {
      "id": "pattr_01HXYZABCDEF",
      "name": "Material",
      "handle": "material",
      "type": "single_select",
      "is_required": false,
      "is_filterable": true,
      "is_variant_axis": false,
      "is_active": true,
      "values": [
        { "id": "pattrval_01HXYZABCDEF", "name": "Linen", "rank": 0 }
      ]
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}