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

# List products

`GET /products`

## Request

- Base URL: `https://api.savanto.ai`
- URL: `https://api.savanto.ai/products`
- Auth: HTTP bearer

List products with optional filters. Supports pagination, category/tag/status filters, and metadata queries.

## Response `200`

Product list

- object
  - `object` 'list', required
  - `requestId` string, required
  - `data` object, required
    - `items` Product[], required
      - `id` string, required
      - `name` string, required
      - `content` string
      - `excerpt` string
      - `searchableText` string
      - `price` number, nullable
      - `salePrice` number, nullable
      - `regularPrice` number, nullable
      - `onSale` boolean
      - `priceMin` number, nullable
      - `priceMax` number, nullable
      - `stockQuantity` number, nullable
      - `stockStatus` 'instock' | 'outofstock' | 'onbackorder'
      - `sku` string
      - `type` 'simple' | 'variable' | 'grouped' | 'external'
      - `weight` number, nullable
      - `dimensions` object, nullable
        - `length` number, nullable
        - `width` number, nullable
        - `height` number, nullable
      - `rating` number, nullable
      - `reviewCount` number
      - `categories` string[]
      - `tags` string[]
      - `brands` string[]
      - `image` string, nullable
      - `url` string
      - `status` string
      - `visibility` string
      - `featured` boolean
      - `virtual` boolean
      - `downloadable` boolean
      - `createdAt` string
      - `updatedAt` string
      - `attributes` object, nullable
      - `metadata` object
      - `source` string
      - `indexStatus` 'active' | 'hidden' | 'disabled'
      - `score` number
      - `matchingChunks` object[]
        - `chunkText` string, required
        - `order` number, required
    - `pagination` Pagination, required
      - `total` number, nullable, required
      - `limit` number, required
      - `hasMore` boolean, required
      - `offset` number
      - `cursor` string, nullable

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `413`: Payload too large
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/savanto/apis/savanto-api.md) · [All operations](https://skmtc.dev/savanto/apis/savanto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/savanto/apis/savanto-api/revisions/82437327a878?raw)