Skip to main content
GET
/
api
/
v3
/
store
/
taxons
/
{id}
Spree SDK
import { createSpreeClient } from '@spree/sdk'

const client = createSpreeClient({
  baseUrl: 'https://your-store.com',
  publishableKey: '<api-key>',
})

const taxon = await client.store.taxons.get('categories/clothing/shirts', {
  expand: 'children,products',
})
{
  "id": "txn_AXs1igzRC6",
  "name": "taxon_20",
  "permalink": "taxonomy-32/taxon-20",
  "position": 0,
  "depth": 1,
  "meta_title": null,
  "meta_description": null,
  "meta_keywords": null,
  "children_count": 1,
  "created_at": "2026-03-05T20:52:46.939Z",
  "updated_at": "2026-03-05T20:52:46.979Z",
  "parent_id": "txn_OIJLhNcSbf",
  "taxonomy_id": "txnmy_VqXmZF31wY",
  "description": "",
  "description_html": "",
  "image_url": null,
  "square_image_url": null,
  "is_root": false,
  "is_child": true,
  "is_leaf": false
}

Authorizations

​
x-spree-api-key
string
header
required

Publishable API key for store access

Headers

​
x-spree-api-key
string
required

Path Parameters

​
id
string
required

Taxon permalink (e.g., categories/clothing/shirts) or prefix ID (e.g., taxon_abc123)

Query Parameters

​
expand
string

Expand associations (children, products, parent)

​
fields
string

Comma-separated list of fields to include (e.g., name,slug,price). id is always included.

Response

taxon found by prefix ID

​
id
string
required
​
name
string
required
​
permalink
string
required
​
position
number
required
​
depth
number
required
​
meta_title
string | null
required
​
meta_description
string | null
required
​
meta_keywords
string | null
required
​
children_count
number
required
​
created_at
string
required
​
updated_at
string
required
​
parent_id
string | null
required
​
taxonomy_id
string
required
​
description
string
required
​
description_html
string
required
​
image_url
string | null
required
​
square_image_url
string | null
required
​
is_root
boolean
required
​
is_child
boolean
required
​
is_leaf
boolean
required
​
parent
any
​
children
array
​
ancestors
array
​
metafields
object[]