---
title: "List goods"
method: GET
path: "/goods"
tags: ["Goods"]
---

# List goods

`GET /goods`

Retrieves a list of goods and categories in the company.

## Query parameters

- `max` integer
- `offset` integer
- `nodeId` integer

## Response `200`

OK

- object
  - `rows` GoodsInfoType[] — Goods information.
    - `id` integer — Goods ID.
    - `name` string, required — Goods name.
    - `data` union, required — Product type-specific properties. Uses discriminator on `type` field: CATEGORY — a folder for organizing items, ITEM — a simple product with price and inventory, VARYING_ITEM — a product with multiple variants (e.g., sizes, colors).
      - object
        - `type` 'CATEGORY' | 'ITEM' | 'VARYING_ITEM', required
      - object
        - `type` 'CATEGORY' | 'ITEM' | 'VARYING_ITEM', required
        - `sku` string, nullable — Item stock number.
        - `price` number — Item price.
        - `description` string, nullable — Item description.
        - `offer` object, nullable — Promotional information.
          - `offerPrice` number, nullable — Discount price.
          - `skipLoyalty` boolean — Flag of goods item price which cashback is not credited and to which the discount does not apply (in currency units).
        - `inventory` GoodsInventory, nullable — Item quantity in stock.
          - `inStock` integer, nullable — Item quantity in stock. The "null" value means unlimited quantity.
        - `photos` string[] — Array of image identifiers
        - `measurement` 'PIECE' | 'CENTIMETRE' | 'METRE' | 'MILLILITRE' | 'LITRE' | 'GRAM' | 'KILOGRAM' | 'TON' | 'SQUARE_METRE' | 'CUBIC_METRE' | 'DAY' | 'HOUR' | 'MINUTE' | 'KILOMETRE' — Goods measurement.
        - `increment` number, nullable — Amount of the item that the buyer can increase or decrease by 1 interval
        - `minQuantity` number, nullable — Minimal quantity of item for order
        - `vatCode` 'NO_NDS' | 'NDS_0' | 'NDS_10' | 'NDS_20' | 'NDS_10_110' | 'NDS_20_120', nullable — VAT rate codes
        - `paymentSubject` 'COMMODITY' | 'EXCISE' | 'SERVICE', nullable — Payment item attribute: * COMMODITY - Commodity * EXCISE - Excise * SERVICE - Service
      - object — A product with multiple variants (e.g., sizes, colors, flavors). Each variant has its own name, price, and inventory.
        - `type` 'CATEGORY' | 'ITEM' | 'VARYING_ITEM', required
        - `variants` GoodsVariantType[] — Variants of item.
          - `name` string — Variant name.
          - `sku` string, nullable — Variant stock number.
          - `price` number — Variant price.
          - `offer` object, nullable — Promotional information.
            - `offerPrice` number, nullable — Discount price.
            - `skipLoyalty` boolean — Flag of goods item price which cashback is not credited and to which the discount does not apply (in currency units).
          - `inventory` GoodsInventory, nullable — Item quantity in stock.
            - `inStock` integer, nullable — Item quantity in stock. The "null" value means unlimited quantity.
        - `description` string, nullable — Variant description.
        - `photos` string[] — Array of image identifiers
        - `vatCode` 'NO_NDS' | 'NDS_0' | 'NDS_10' | 'NDS_20' | 'NDS_10_110' | 'NDS_20_120', nullable — VAT rate codes
        - `paymentSubject` 'COMMODITY' | 'EXCISE' | 'SERVICE', nullable — Payment item attribute: * COMMODITY - Commodity * EXCISE - Excise * SERVICE - Service
    - `hidden` boolean — Is the goods hidden.
    - `blocked` boolean — Is the goods blocked.
    - `nodeId` integer, nullable — ID of the category in which the product is included
    - `imageUrls` string[] — Array of imageId from presigned url response
    - `externalId` string, nullable — External goods identifier.
    - `dateCreated` string, date-time — Date item created.
  - `total` integer — Goods amount.

---

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