---
title: "List Products"
method: GET
path: "/companies/{company_id}/products"
tags: ["products"]
---

# List Products

`GET /companies/{company_id}/products`

## Request

- Base URL: `https://app.zalster.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zalster.com/companies/{company_id}/products`
- Auth: none declared

Find products. Without the three filters below, every product of every source.

``source_id`` keeps one source's products, still supplied or since retired
(``is_active`` narrows it). ``product_set_id`` keeps the set's members:
active products of its sources, matched by the set matcher over the same
products its ``product_count`` counts, so list and count agree.
``template_id`` keeps the products of the sources the template makes
creatives for (decision 202): the editor's products. ``image=failed`` keeps
the products an image failed to download for (decision 221), with any of
the others.

## Path parameters

- `company_id` string, uuid, required: Company id

## Query parameters

- `search` string, nullable
- `brand` string, nullable
- `availability` string, nullable
- `is_active` boolean, nullable
- `item_group_id` string, nullable
- `min_price` union
  - number
  - string
- `max_price` union
  - number
  - string
- `source_id` string, uuid, nullable: Only the products of this source.
- `source_feed_id` string, uuid, nullable: Deprecated: ``source_id``.
- `product_set_id` string, uuid, nullable: Only the products in this product set, as the set counts them.
- `template_id` string, uuid, nullable: Only the products of the sources this template makes creatives for.
- `image` 'failed', nullable: ``failed``: only the products with an image whose download failed, as the Images page counts them.
- `sort` string
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- PageProductListItem
  - `items` ProductListItem[], required
    - `id` string, uuid, required
    - `source_id` string, uuid, required
    - `source_name` string, nullable
    - `external_id` string, required
    - `item_group_id` string, nullable, required
    - `title` string, nullable, required
    - `brand` string, nullable, required
    - `availability` string, nullable, required
    - `price_amount` string, nullable, required
    - `currency` string, nullable, required
    - `sale_price_amount` string, nullable, required
    - `is_active` boolean, required
    - `last_seen_at` string, date-time, required
    - `primary_image_url` string, nullable
    - `thumbnail_path` string, nullable
    - `variant_count` integer
  - `next_cursor` string, nullable
  - `has_more` boolean
  - `total` integer, nullable
  - `total_more` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zalster/apis/zalster-feed-processor.md) - [All operations](https://skmtc.dev/zalster/apis/zalster-feed-processor/llms.txt) - [OpenAPI document](https://skmtc.dev/zalster/apis/zalster-feed-processor/revisions/d0b9dc66ad36?raw)