---
title: "List products"
method: GET
path: "/products"
tags: ["Products"]
---

# List products

`GET /products`

## Query parameters

- `page` union — Page number
  - integer
  - unknown
- `page_size` union — Items per page
  - integer
  - unknown
- `q` union
  - string
  - unknown
- `sort_by` union
  - 'popularity_order' | 'price' | 'display_order' | 'created_at'
  - string
- `order` union
  - 'asc' | 'desc'
  - string
  - unknown
- `categories` union — Filter by category
  - string
  - unknown
- `price_min` union — Minimum price filter
  - number
  - unknown
- `price_max` union — Maximum price filter
  - number
  - unknown
- `on_sale` union — Filter on sale products
  - boolean
  - unknown
- `attribute_values` union — Filter by attribute values
  - string[]
  - unknown
- `availability` union — Stock availability filter: in_stock, out_of_stock
  - 'in_stock' | 'out_of_stock'
  - string

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/johrh/apis/vitrin.md) · [All operations](https://skmtc.net/johrh/apis/vitrin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/johrh/vitrin/versions/a230727512fd/schema)