> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.noyax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List changed products

> Products whose card, prices or stock changed since a given time, for periodic synchronization.

Use this endpoint to keep products, prices and quantities on hand in sync on your side, for example every two hours. It needs both the product read and the stock read permission.

## What counts as a change

A product is returned when, at or after `modifiedSince`:

* its product card was created, updated or deleted,
* any of its prices was added, updated or deleted,
* for a variant, any of its main product's prices was added, updated or deleted,
* for a variant with no product groups, its main product's card or one of its main product's groups changed,
* one of its product groups was changed (for example renamed); every product in that group is returned, or
* its stock moved: a stock movement of the product was created, updated or deleted (despatches, invoices, and transfers or counts made in Noyax).

## What is returned

Each product is returned with its **current state**, not with what changed: a summary of the product card with its product groups (`Group1`–`Group5`), its prices that **have not expired yet** (current and future ones), the quantity on hand (`Quantity`, in the main unit, all warehouses together) and the stock per warehouse (`Warehouses`). For each warehouse, a lot-tracked product also returns its remaining lots and a serial-tracked product its serial numbers in stock; warehouses with no stock are left out. Replace the product on your side with what you receive; receiving the same product twice is harmless. A deleted product is returned with `IsDeleted: true` and only `Id`, `Code` and `Name`; remove it on your side. A deleted price simply no longer appears in the product's `Prices` list.

**Variant prices:** for a variant with no unexpired price of its own, `Prices` holds the prices of its main product (`MainProductId`) and `PricesFromMainProduct` is `true`. These prices belong to the main product; do not save them as the variant's own prices. Once the variant gets a price of its own, `Prices` returns its own prices and `PricesFromMainProduct` is `false`.

**Variant product groups:** for a variant with none of the five product groups selected, `Group1`–`Group5` (and `GroupDetailId1`–`GroupDetailId5`) hold the groups of its main product and `GroupsFromMainProduct` is `true`. The groups are taken all together, never field by field: if even one group is selected on the variant, only the variant's own groups are returned.

A price that expires is not a change, so the product is not returned again just because of that. Use `StartDate` and `EndDate` to pick the valid price on your side.

## Synchronizing

Results are paged: request `page` 1, 2, ... (`pageSize` up to 200) until `page × pageSize` reaches `TotalCount`.

1. **Initial load:** call without `modifiedSince`. All products are returned page by page in the same format: main products first, then variants, each ordered by product code. So when you receive a variant, its main product has already been returned (in this or an earlier page).
2. Store the `ServerTime` of the **first page** of the run.
3. **Next runs** (for example every two hours): send the stored `ServerTime` as `modifiedSince`. Use the same value for every page of one run, then store the `ServerTime` of that run's first page.

`modifiedSince` can be **at most 24 hours in the past** (`2091`). If no run succeeds for more than 24 hours, do the initial load again.

`ServerTime` is in server time without a time zone (for example `2026-10-14T15:01:25`); send it back as it is. `ServerTime` is read before the changes, so a change made while the pages are being read is returned again in the next run. Because each product is returned in full, you can safely send a slightly earlier `modifiedSince` (for example a few minutes before `ServerTime`) for extra safety.

## Error codes

Codes this endpoint can return. The [general errors](https://apidocs.noyax.com/en/v1/guides/result-codes.md) that apply to every endpoint (authentication, permissions, request headers, request limits) are not repeated here.

| Code | HTTP | Meaning |
| - | - | - |
| `2091` | 400 | `modifiedSince` is more than 24 hours in the past or in the future |


## OpenAPI

````yaml api-reference/openapi.json GET /api/v1/products/changes
openapi: 3.1.1
info:
  title: Noyax API
  description: Server-to-server API for integrations to access Noyax data.
  version: '1.0'
servers:
  - url: https://api.noyax.com
security:
  - Bearer: []
tags:
  - name: Product Stock Status
  - name: Sections
  - name: Warehouses
  - name: Quotes
  - name: Product Critical Stock
  - name: Product groups
  - name: Product Parameter Definitions
  - name: Product Parameters
  - name: Product Prices
  - name: Products
  - name: Orders
  - name: Purchase Invoices
  - name: Purchase Return Invoices
  - name: Sales Invoices
  - name: Sales Return Invoices
  - name: Bank Accounts
  - name: Bank Internal Transfers
  - name: Bank Openings
  - name: Banks
  - name: Bank Transfers
  - name: Credit Card Collections
  - name: Customer Balances
  - name: Customer Transactions
  - name: Repayment Plans
  - name: Despatches
  - name: Cities
  - name: Countries
  - name: Currencies
  - name: Districts
  - name: Line Groups
  - name: Shipment Definitions
  - name: Units
  - name: VAT rates
  - name: Customer Addresses
  - name: Customer Bank Accounts
  - name: Customer Definitions
  - name: Customer Group Members
  - name: Customer Links
  - name: Customer Parameters
  - name: Customer Representatives
  - name: Customers
  - name: Customer Telephones
paths:
  /api/v1/products/changes:
    get:
      tags:
        - Products
      summary: List changed products
      description: >-
        Returns the products whose card, any of their prices (for a variant,
        also its main product's prices and, when it has no product groups, its
        main product's card), their stock or one of their product groups changed
        after modifiedSince, with their current state: a summary of the product
        card with its product groups (a variant without product groups gets its
        main product's groups), its prices that have not expired yet (a variant
        without prices of its own gets its main product's prices) and the stock
        per warehouse with the remaining lots and serial numbers. Deleted
        products are returned with IsDeleted set to true. Without modifiedSince,
        all products are returned (initial load); with it, modifiedSince can be
        at most 24 hours in the past. Send the ServerTime of the first page of
        the previous synchronization as modifiedSince; use the same
        modifiedSince for every page of one synchronization.
      parameters:
        - name: modifiedSince
          in: query
          description: >-
            Return only the products that changed at or after this time; at most
            24 hours in the past and not in the future. Leave empty for the
            initial load.
          schema:
            type: string
            format: date-time
        - name: page
          in: query
          description: Page number, starting from 1.
          schema:
            type: integer
            format: int32
            default: 1
        - name: pageSize
          in: query
          description: Records per page (maximum 200).
          schema:
            type: integer
            format: int32
            default: 200
        - name: X-UserID
          in: header
          description: >-
            ID of the Noyax user the request is made on behalf of. Written to
            the audit fields of created, updated and deleted records.
          required: true
          schema:
            minimum: 1
            type: integer
            format: int32
        - name: X-CompanyID
          in: header
          description: >-
            ID of the company. The user must be assigned to this company. All
            reads and writes are limited to this company.
          required: true
          schema:
            minimum: 1
            type: integer
            format: int32
        - name: X-PeriodID
          in: header
          description: >-
            ID of the accounting period. Optional; if sent, it is written to
            created records.
          schema:
            minimum: 1
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataResultOfProductChangesDto'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '2091'
                Message: >-
                  modifiedSince must be within the last 24 hours and cannot be
                  in the future.
                Errors:
                  - Code: '2091'
                    Message: >-
                      modifiedSince must be within the last 24 hours and cannot
                      be in the future.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0102'
                Message: Token has expired. Obtain a new token using the refresh token.
                Errors:
                  - Code: '0102'
                    Message: >-
                      Token has expired. Obtain a new token using the refresh
                      token.
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0110'
                Message: You do not have permission for this operation.
                Errors:
                  - Code: '0110'
                    Message: You do not have permission for this operation.
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResult'
              example:
                Success: false
                ResultCode: '0120'
                Message: Daily request limit (10000) exceeded.
                Errors:
                  - Code: '0120'
                    Message: Daily request limit (10000) exceeded.
components:
  schemas:
    DataResultOfProductChangesDto:
      required:
        - Success
        - ResultCode
        - Data
      type: object
      properties:
        Success:
          type: boolean
          description: Whether the operation succeeded.
          example: true
        ResultCode:
          type: string
          description: >-
            "0000" on success. On failure, the code of the first error; all
            errors are listed in Errors.
          example: '0000'
        Message:
          type:
            - 'null'
            - string
          description: >-
            Error message when Success is false. Messages of all errors are
            joined into a single text.
        Data:
          $ref: '#/components/schemas/ProductChangesDto'
    ErrorResult:
      type: object
      properties:
        Success:
          type: boolean
          description: Whether the operation succeeded.
          example: false
        ResultCode:
          type:
            - 'null'
            - string
          description: >-
            "0000" on success. On failure, the code of the first error; all
            errors are listed in Errors.
        Message:
          type:
            - 'null'
            - string
          description: >-
            Error message when Success is false. Messages of all errors are
            joined into a single text.
        TraceId:
          type:
            - 'null'
            - string
          description: >-
            Support reference of an unexpected server error (ResultCode 0001).
            Share it with Noyax support so the error can be found. Only present
            on 500 responses.
        Errors:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/ResultError'
          description: All errors with their codes. Only present when Success is false.
        ExistingId:
          type:
            - 'null'
            - string
          description: >-
            ID of the record that already exists, when the error is a duplicate
            (for example 1002: the customer that already uses the CustomerCode).
            Only present on such errors.
          format: uuid
    ProductChangesDto:
      type: object
      properties:
        ServerTime:
          type: string
          description: >-
            Server time when the changes were read. Send it as modifiedSince in
            the next request.
          format: date-time
          example: '2026-10-14T10:00:03'
        Page:
          type: integer
          description: Current page number.
          format: int32
          example: 1
        PageSize:
          type: integer
          description: Records per page.
          format: int32
          example: 50
        TotalCount:
          type: integer
          description: Total number of records matching the query.
          format: int32
          example: 128
        Items:
          type: array
          items:
            $ref: '#/components/schemas/ProductChangeDto'
          description: Records on this page.
      description: Response data. Null when Success is false.
    ResultError:
      required:
        - Code
        - Message
      type: object
      properties:
        Code:
          type: string
          description: Error code. See the result codes page for the full list.
        Message:
          type: string
          description: Error description.
    ProductChangeDto:
      type: object
      properties:
        Id:
          type: string
          description: Product ID.
          format: uuid
        Code:
          type:
            - 'null'
            - string
          description: Product code.
          example: URN-0001
        Name:
          type:
            - 'null'
            - string
          description: Product name.
          example: VİDA 5X40 GALVANİZ
        MainProductId:
          type:
            - 'null'
            - string
          description: >-
            ID of the main product when this product is a variant; null when the
            product is itself a main product.
          format: uuid
          example: null
        MainProductCode:
          type:
            - 'null'
            - string
          description: >-
            Code of the main product when this product is a variant; null when
            the product is itself a main product.
          example: null
        IsDeleted:
          type: boolean
          description: >-
            True when the product has been deleted; only Id, Code and Name are
            filled. Remove the product on your side.
          example: false
        Barcode:
          type:
            - 'null'
            - string
          description: Barcode of the main unit. At most 30 characters.
          example: '8690000000017'
        ECommerceProductCode:
          type:
            - 'null'
            - string
          description: >-
            Product code used by the e-commerce integration. At most 50
            characters.
        UnitCode:
          type:
            - 'null'
            - string
          description: >-
            Code of the main unit: the unit's universal code (for example C62
            for ADET) or, when the unit has no universal code, its name.
          example: C62
        UnitName:
          type:
            - 'null'
            - string
          description: Name of the main unit.
          example: ADET
        ProductType:
          type: integer
          description: >-
            Product type: 1 Raw material, 2 Semi-finished good, 3 Finished good,
            4 Commercial good, 5 Service. Defaults to 4.
          format: int32
          example: 4
        StockType:
          type: integer
          description: >-
            Stock type: 1 No stock tracking, 2 Stock tracking, 3 Lot, 4 FIFO, 5
            Serial, 6 LIFO, 7 FEFO. Defaults to 1.
          format: int32
          example: 2
        VatRate:
          type:
            - 'null'
            - integer
          description: >-
            VAT rate in percent, one of the rates from GET
            /api/v1/definitions/vat-rates.
          format: int32
          example: 20
        IsOutOfUse:
          type: boolean
          description: >-
            Whether the product is out of use. Out of use products are kept but
            are not offered in new records.
          example: false
        Group1:
          type:
            - 'null'
            - string
          description: >-
            Name of the product's group 1 detail (from GET
            /api/v1/products/groups). Null when not selected and for a deleted
            product.
        GroupDetailId1:
          type:
            - 'null'
            - string
          description: >-
            ID of the product's group 1 detail. Null when not selected and for a
            deleted product.
          format: uuid
        Group2:
          type:
            - 'null'
            - string
          description: >-
            Name of the product's group 2 detail (from GET
            /api/v1/products/groups). Null when not selected and for a deleted
            product.
        GroupDetailId2:
          type:
            - 'null'
            - string
          description: >-
            ID of the product's group 2 detail. Null when not selected and for a
            deleted product.
          format: uuid
        Group3:
          type:
            - 'null'
            - string
          description: >-
            Name of the product's group 3 detail (from GET
            /api/v1/products/groups). Null when not selected and for a deleted
            product.
        GroupDetailId3:
          type:
            - 'null'
            - string
          description: >-
            ID of the product's group 3 detail. Null when not selected and for a
            deleted product.
          format: uuid
        Group4:
          type:
            - 'null'
            - string
          description: >-
            Name of the product's group 4 detail (from GET
            /api/v1/products/groups). Null when not selected and for a deleted
            product.
        GroupDetailId4:
          type:
            - 'null'
            - string
          description: >-
            ID of the product's group 4 detail. Null when not selected and for a
            deleted product.
          format: uuid
        Group5:
          type:
            - 'null'
            - string
          description: >-
            Name of the product's group 5 detail (from GET
            /api/v1/products/groups). Null when not selected and for a deleted
            product.
        GroupDetailId5:
          type:
            - 'null'
            - string
          description: >-
            ID of the product's group 5 detail. Null when not selected and for a
            deleted product.
          format: uuid
        GroupsFromMainProduct:
          type: boolean
          description: >-
            True when the product is a variant with none of the five product
            groups selected and Group1–Group5 (with
            GroupDetailId1–GroupDetailId5) hold the groups of its main product
            (MainProductId). The groups are taken from the main product all
            together, never field by field.
        Quantity:
          type:
            - 'null'
            - number
          description: >-
            Quantity on hand in the main unit, all warehouses together (the same
            value as the product stock status). Null for a deleted product.
          format: double
          example: 175
        Warehouses:
          type: array
          items:
            $ref: '#/components/schemas/ProductChangeWarehouseDto'
          description: >-
            Stock per warehouse: quantity on hand, remaining lots and serial
            numbers in stock. Warehouses with no stock are left out. Empty for a
            deleted product.
        Prices:
          type: array
          items:
            $ref: '#/components/schemas/ProductPriceDto'
          description: >-
            Prices of the product that have not expired yet (current and future;
            purchase and sales, every scope). Expired prices are left out. For a
            variant that has no such price of its own, the main product's prices
            are returned and PricesFromMainProduct is true. Empty for a deleted
            product. Replace the product's prices on your side with this list.
        PricesFromMainProduct:
          type: boolean
          description: >-
            True when the product is a variant with no unexpired price of its
            own and Prices holds the prices of its main product (MainProductId).
            These prices belong to the main product; do not save them as the
            variant's own prices.
    ProductChangeWarehouseDto:
      type: object
      properties:
        WarehouseName:
          type:
            - 'null'
            - string
          description: >-
            Warehouse name. Null for stock movements entered without a
            warehouse.
          example: MERKEZ DEPO
        Quantity:
          type: number
          description: Quantity on hand in this warehouse, in the main unit.
          format: double
          example: 175
        Lots:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/ProductStockLotDto'
          description: >-
            Remaining quantity per lot, only when the product's StockType is 3
            (Lot), 4 (FIFO), 6 (LIFO) or 7 (FEFO). Lots with no remaining
            quantity are left out. Null when the product's StockType is not one
            of these.
        SerialNumbers:
          type:
            - 'null'
            - array
          items:
            type: string
          description: >-
            Serial numbers currently in stock (entered but not yet exited), only
            when the product's StockType is 5 (Serial). Null when the product's
            StockType is not 5.
    ProductPriceDto:
      type: object
      properties:
        Id:
          type: string
          description: Price/discount row ID.
          format: uuid
        ProductId:
          type: string
          description: Product ID.
          format: uuid
        CurrencyId:
          type:
            - 'null'
            - string
          description: Currency ID.
          format: uuid
        UnitId:
          type:
            - 'null'
            - string
          description: Unit ID.
          format: uuid
        CustomerId:
          type:
            - 'null'
            - string
          description: Customer ID, when CustomerCode is set.
          format: uuid
        CustomerGroupId:
          type:
            - 'null'
            - string
          description: Customer group ID, when CustomerGroup is set.
          format: uuid
        CustomerGroupDetailId:
          type:
            - 'null'
            - string
          description: Customer group detail ID, when CustomerGroupDetail is set.
          format: uuid
        UnitName:
          type:
            - 'null'
            - string
          description: Name of the unit.
        CustomerName:
          type:
            - 'null'
            - string
          description: Name of the customer, when CustomerCode is set.
        PriceType:
          type: integer
          description: 'Required. 1: Purchase, 2: Sales.'
          format: int32
          example: 2
        Price:
          type: number
          description: Required. Must be greater than 0.
          format: double
          example: 450
        CurrencyCode:
          type:
            - 'null'
            - string
          description: Required. Currency code from GET /api/v1/definitions/currencies.
          example: TRY
        IncludesVat:
          type: boolean
          description: Whether Price includes VAT.
          example: false
        Discount:
          type: number
          description: >-
            Discount amount or percentage, depending on IsDiscountPercentage.
            Cannot be negative.
          format: double
          example: 10
        IsDiscountPercentage:
          type: boolean
          description: >-
            Whether Discount is a percentage (0-100) rather than a fixed amount.
            Defaults to true.
          example: true
        UnitCode:
          type:
            - 'null'
            - string
          description: >-
            Required. Unit code (the unit's universal code, for example C62, or
            its name when it has no universal code). It must be one of the
            product's own units: its main unit or, for products with a
            second/third unit, one of those.
          example: C62
        StartDate:
          type:
            - 'null'
            - string
          description: Required. Start of the validity period.
          format: date-time
        EndDate:
          type:
            - 'null'
            - string
          description: Required. End of the validity period. Must be after StartDate.
          format: date-time
        CustomerCode:
          type:
            - 'null'
            - string
          description: >-
            Scope: applies only to the customer with this customer code. Cannot
            be combined with CustomerGroup or CustomerGroupDetail. Leave every
            scope field empty for a general price.
        CustomerGroup:
          type:
            - 'null'
            - string
          description: >-
            Scope: applies to every customer in this group (group name from GET
            /api/v1/customers/groups), unless CustomerGroupDetail narrows it to
            one detail. Cannot be combined with CustomerCode.
        CustomerGroupDetail:
          type:
            - 'null'
            - string
          description: >-
            Scope: narrows CustomerGroup to customers with this group detail
            (detail name). Requires CustomerGroup to be set.
        Description:
          type:
            - 'null'
            - string
          description: Description. At most 255 characters.
    ProductStockLotDto:
      type: object
      properties:
        LotNo:
          type:
            - 'null'
            - string
          description: Lot number.
          example: LOT-2026-001
        Quantity:
          type: number
          description: Remaining quantity of this lot, in UnitCode.
          format: double
  securitySchemes:
    Bearer:
      type: http
      description: Access token obtained from the Noyax auth service with your API key.
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.