Skip to main content
GET
List changed products
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 that apply to every endpoint (authentication, permissions, request headers, request limits) are not repeated here.

Authorizations

Authorization
string
header
required

Access token obtained from the Noyax auth service with your API key.

Headers

X-UserID
integer<int32>
required

ID of the Noyax user the request is made on behalf of. Written to the audit fields of created, updated and deleted records.

Required range: x >= 1
X-CompanyID
integer<int32>
required

ID of the company. The user must be assigned to this company. All reads and writes are limited to this company.

Required range: x >= 1
X-PeriodID
integer<int32>

ID of the accounting period. Optional; if sent, it is written to created records.

Required range: x >= 1

Query Parameters

modifiedSince
string<date-time>

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.

page
integer<int32>
default:1

Page number, starting from 1.

pageSize
integer<int32>
default:200

Records per page (maximum 200).

Response

OK

Success
boolean
required

Whether the operation succeeded.

Example:

true

ResultCode
string
required

"0000" on success. On failure, the code of the first error; all errors are listed in Errors.

Example:

"0000"

Data
object
required

Response data. Null when Success is false.

Message
null | string

Error message when Success is false. Messages of all errors are joined into a single text.