List changed products
curl --request GET \
--url https://api.noyax.com/api/v1/products/changes \
--header 'Authorization: Bearer <token>' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/products/changes");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'GET',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.noyax.com/api/v1/products/changes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/products/changes"
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"ServerTime": "2026-10-14T10:00:03",
"Page": 1,
"PageSize": 50,
"TotalCount": 128,
"Items": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Code": "URN-0001",
"Name": "VİDA 5X40 GALVANİZ",
"MainProductId": null,
"MainProductCode": null,
"IsDeleted": false,
"Barcode": "8690000000017",
"ECommerceProductCode": "<string>",
"UnitCode": "C62",
"UnitName": "ADET",
"ProductType": 4,
"StockType": 2,
"VatRate": 20,
"IsOutOfUse": false,
"Group1": "<string>",
"GroupDetailId1": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group2": "<string>",
"GroupDetailId2": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group3": "<string>",
"GroupDetailId3": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group4": "<string>",
"GroupDetailId4": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group5": "<string>",
"GroupDetailId5": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"GroupsFromMainProduct": true,
"Quantity": 175,
"Warehouses": [
{
"WarehouseName": "MERKEZ DEPO",
"Quantity": 175,
"Lots": [
{
"LotNo": "LOT-2026-001",
"Quantity": 123
}
],
"SerialNumbers": [
"<string>"
]
}
],
"Prices": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ProductId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"UnitName": "<string>",
"CustomerName": "<string>",
"PriceType": 2,
"Price": 450,
"CurrencyCode": "TRY",
"IncludesVat": false,
"Discount": 10,
"IsDiscountPercentage": true,
"UnitCode": "C62",
"StartDate": "2023-11-07T05:31:56Z",
"EndDate": "2023-11-07T05:31:56Z",
"CustomerCode": "<string>",
"CustomerGroup": "<string>",
"CustomerGroupDetail": "<string>",
"Description": "<string>"
}
],
"PricesFromMainProduct": true
}
]
},
"Message": "<string>"
}{
"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."
}
]
}{
"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."
}
]
}{
"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."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}Products
List changed products
Products whose card, prices or stock changed since a given time, for periodic synchronization.
GET
/
api
/
v1
/
products
/
changes
List changed products
curl --request GET \
--url https://api.noyax.com/api/v1/products/changes \
--header 'Authorization: Bearer <token>' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/products/changes");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'GET',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.noyax.com/api/v1/products/changes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/products/changes"
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"ServerTime": "2026-10-14T10:00:03",
"Page": 1,
"PageSize": 50,
"TotalCount": 128,
"Items": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Code": "URN-0001",
"Name": "VİDA 5X40 GALVANİZ",
"MainProductId": null,
"MainProductCode": null,
"IsDeleted": false,
"Barcode": "8690000000017",
"ECommerceProductCode": "<string>",
"UnitCode": "C62",
"UnitName": "ADET",
"ProductType": 4,
"StockType": 2,
"VatRate": 20,
"IsOutOfUse": false,
"Group1": "<string>",
"GroupDetailId1": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group2": "<string>",
"GroupDetailId2": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group3": "<string>",
"GroupDetailId3": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group4": "<string>",
"GroupDetailId4": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Group5": "<string>",
"GroupDetailId5": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"GroupsFromMainProduct": true,
"Quantity": 175,
"Warehouses": [
{
"WarehouseName": "MERKEZ DEPO",
"Quantity": 175,
"Lots": [
{
"LotNo": "LOT-2026-001",
"Quantity": 123
}
],
"SerialNumbers": [
"<string>"
]
}
],
"Prices": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"ProductId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"UnitId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerGroupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerGroupDetailId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"UnitName": "<string>",
"CustomerName": "<string>",
"PriceType": 2,
"Price": 450,
"CurrencyCode": "TRY",
"IncludesVat": false,
"Discount": 10,
"IsDiscountPercentage": true,
"UnitCode": "C62",
"StartDate": "2023-11-07T05:31:56Z",
"EndDate": "2023-11-07T05:31:56Z",
"CustomerCode": "<string>",
"CustomerGroup": "<string>",
"CustomerGroupDetail": "<string>",
"Description": "<string>"
}
],
"PricesFromMainProduct": true
}
]
},
"Message": "<string>"
}{
"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."
}
]
}{
"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."
}
]
}{
"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."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}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 aftermodifiedSince:
- 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: requestpage 1, 2, … (pageSize up to 200) until page × pageSize reaches TotalCount.
- 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). - Store the
ServerTimeof the first page of the run. - Next runs (for example every two hours): send the stored
ServerTimeasmodifiedSince. Use the same value for every page of one run, then store theServerTimeof 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.| Code | HTTP | Meaning |
|---|---|---|
2091 | 400 | modifiedSince is more than 24 hours in the past or in the future |
Authorizations
Headers
Query Parameters
Response
OK