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

# List or search products

`GET /products`

Without q, returns all active products and applies sort. With q, trims the value and performs a case-insensitive name or SKU search limited to 200 products; sort is not applied to search results. An empty q value returns an empty products array.

## Query parameters

- `q` string
- `sort` 'name' | '-name' | 'sku' | '-sku'

## Response `200`

List of products

- ProductResponse — A full response object for a product-related endpoint.
  - `products` Product[]
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` unknown
    - `href` unknown
    - `description` unknown
    - `modifiedTime` integer
    - `deletedTime` string, date-time
    - `sku` unknown
    - `productType` unknown
    - `prices` object
      - `1-markets` ProductPrice
        - `amount` number
        - `currency` string
        - `formatted` string
        - `currencySymbol` string
    - `price` ProductPrice
      - `amount` number
      - `currency` string
      - `formatted` string
      - `currencySymbol` string

## Other responses

- `401` — Authentication required
- `403` — OAuth token missing the read scope

---

[API](https://skmtc.dev/nutshell/apis/nutshell-api.md) · [All operations](https://skmtc.dev/nutshell/apis/nutshell-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nutshell/nutshell-api/revisions/14f59cf6a09a/schema)