List Products

Required scope: catalog:read

Returns active products that can be selected when creating a quote. Results can be limited to one catalog folder. pageSize defaults to 100 and is capped at 100. Product prices and quote unit prices are integer minor currency units (cents for currencies such as EUR and USD). countryPrices exposes the available country-specific rows used by CreateQuote; each row includes its country-derived currency. The top-level price fields remain the legacy/default product representation.

Generated Reference

POST /public-api/publicapi.v1.Catalog/ListProducts

Lists active products available to the API key actor.

Request ListProductsRequest

Response ListProductsResponse

ListProductsRequest

Field	Type
`folder_id`	`optional string`
`page_size`	`int32`

ListProductsResponse

Field	Type
`products`	`repeated Product`

Related Types

Product

Field	Type
`id`	`string`
`folder_id`	`optional string`
`name`	`string`
`description`	`string`
`sku`	`string`
`price_once`	`optional int32`
`price_monthly`	`optional int32`
`price_yearly`	`optional int32`
`currency`	`string`
`is_active`	`bool`
`min_quantity`	`optional int32`
`max_quantity`	`optional int32`
`product_kind`	`string`
`country_prices`	`repeated ProductCountryPrice`

ProductCountryPrice

Field	Type
`country_code`	`string`
`currency`	`string`
`price_once`	`optional int32`
`price_once_max`	`optional int32`
`price_monthly`	`optional int32`
`price_monthly_max`	`optional int32`
`price_yearly`	`optional int32`
`price_yearly_max`	`optional int32`
`vat_rate`	`double`

Request

{
  "folderId": "<catalog-folder-id>",
  "pageSize": 50
}

Omit folderId to list products across folders.

Response

{
  "products": [
    {
      "id": "<product-id>",
      "name": "Solar panel",
      "description": "430 W panel",
      "sku": "PV-430",
      "priceOnce": 18900,
      "currency": "EUR",
      "countryPrices": [
        {
          "countryCode": "US",
          "currency": "USD",
          "priceOnce": 20500,
          "vatRate": 0
        }
      ],
      "isActive": true,
      "minQuantity": 1,
      "productKind": "simple"
    }
  ]
}