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

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

const products = await client.store.taxons.products.list('categories/clothing', {
  page: 1,
  limit: 25,
  sort: 'price asc',
  with_option_value_ids: ['optval_abc'],
})
{
  "data": [
    {
      "id": "prod_UkLWZg9DAJ",
      "name": "Product 1199704",
      "description": "Voluptatem ullam rerum repellat officiis debitis repellendus placeat. Ut aliquam atque quas totam doloribus ipsa at. Voluptas iusto sit sunt explicabo. Dolorem quo cupiditate molestias tempore laudantium eligendi a.\nRepudiandae rem quo totam assumenda aliquam nihil dolores id. Blanditiis doloribus ex qui distinctio. Recusandae quibusdam cumque officiis incidunt suscipit.",
      "slug": "product-1199704",
      "meta_description": null,
      "meta_keywords": null,
      "variant_count": 0,
      "available_on": "2025-03-05T20:52:47.754Z",
      "created_at": "2026-03-05T20:52:47.772Z",
      "updated_at": "2026-03-05T20:52:47.789Z",
      "purchasable": true,
      "in_stock": false,
      "backorderable": true,
      "available": true,
      "default_variant_id": "variant_UkLWZg9DAJ",
      "thumbnail_url": null,
      "tags": [],
      "price": {
        "id": "price_UkLWZg9DAJ",
        "amount": "19.99",
        "amount_in_cents": 1999,
        "compare_at_amount": null,
        "compare_at_amount_in_cents": null,
        "currency": "USD",
        "display_amount": "$19.99",
        "display_compare_at_amount": null,
        "price_list_id": null
      },
      "original_price": null
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "count": 1,
    "pages": 1,
    "from": 1,
    "to": 1,
    "in": 1,
    "previous": null,
    "next": null
  }
}

Authorizations

​
x-spree-api-key
string
header
required

Publishable API key for store access

Headers

​
x-spree-api-key
string
required

Path Parameters

​
taxon_id
string
required

Taxon permalink or prefix ID

Query Parameters

​
page
integer

Page number (default: 1)

​
limit
integer

Number of items per page (default: 25, max: 100)

​
sort
string

Sort order. Values: price asc, price desc, best_selling, name asc, name desc, available_on desc, available_on asc

​
q[price_gte]
number

Filter by minimum price

​
q[price_lte]
number

Filter by maximum price

​
q[with_option_value_ids][]
string

Filter by option value prefix IDs

​
q[in_stock]
boolean

Filter to only in-stock products

​
fields
string

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

Response

products found

​
data
object[]
​
meta
object