List sales invoices
curl --request GET \
--url https://api.noyax.com/api/v1/sales-invoices \
--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/sales-invoices");
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/sales-invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/sales-invoices"
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": {
"Page": 1,
"PageSize": 50,
"TotalCount": 128,
"Items": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerName": "<string>",
"Cancelled": true,
"CurrencyCode": "TRY",
"ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Address": "<string>",
"CustomerTitle": "<string>",
"TaxNumber": "<string>",
"TaxOffice": "<string>",
"EInvoiceType": 2,
"InvoiceNumber": "FAT2026000125",
"DocumentNumber": "<string>",
"Date": "2026-09-21T10:30:00",
"Description": "<string>",
"CustomerCode": "C-0001",
"DueDays": 123,
"SharingCode": "<string>",
"ShipmentDefinitionCode": "<string>",
"DiscountTotal": 100,
"SubTotal": 900,
"VatTotal": 225,
"GrandTotal": 1350,
"Consolidated": true,
"PrintDescription": true,
"ApplyWithholding": true,
"WithholdingCode": "<string>",
"WithholdingNumerator": 123,
"WithholdingDenominator": 123,
"WithholdingTotal": 0,
"AdditionalTaxTotal": 225,
"ProfileId": "<string>",
"InvoiceTypeCode": "<string>",
"WithholdingTaxRate": 123,
"SocialSecurityRate": 123,
"MarketRate": 123,
"ReturnedInvoiceNumber": "<string>",
"ReturnedInvoiceDate": "2026-10-15",
"OrderReferenceNumber": "<string>",
"OrderReferenceDate": "2026-10-15",
"BranchNumber": "<string>",
"BranchTitle": "<string>",
"BranchAddress": "<string>",
"InvestmentIncentiveDocumentNumber": "<string>",
"InvestmentIncentiveDocumentDate": "2026-10-15",
"EnergyPeriodStart": "2023-11-07T05:31:56Z",
"EnergyPeriodEnd": "2023-11-07T05:31:56Z",
"DeliveryInfo": {
"DeliveryTerm": "<string>",
"TransportModeCode": 123,
"Country": "<string>",
"CityName": "<string>",
"CitySubdivisionName": "<string>",
"StreetName": "<string>",
"BuildingName": "<string>",
"BuildingNumber": "<string>",
"PostalZone": "<string>",
"TransportMeans": "<string>",
"DeclaredForCarriageValueAmount": 123,
"DeliveryInsuranceValue": 123
},
"PaymentMeans": [
{
"PaymentMeansCode": "<string>",
"PayeeFinancialAccountID": "<string>",
"CurrencyCode": "<string>"
}
],
"ReferencedDespatches": [
{
"ID": "<string>",
"IssueDate": "2023-11-07T05:31:56Z"
}
],
"CustomerIdentitySchemes": [
{
"SchemeID": "<string>",
"Value": "<string>"
}
],
"PublicSectorSpendingUnit": {
"BCP_Name": "<string>",
"BCP_VKN": "<string>",
"BCP_Country": "<string>",
"BCP_CityName": "<string>",
"BCP_CitySubdivisionName": "<string>"
},
"SgkInfo": {
"StartDate": "2023-11-07T05:31:56Z",
"EndDate": "2023-11-07T05:31:56Z",
"MukellefKodu": "<string>",
"MukellefAdi": "<string>",
"DosyaNo": "<string>",
"FaturaAltTipi": "<string>"
},
"AverageExchangeRate": 1,
"CreateDate": "2023-11-07T05:31:56Z",
"ModifyDate": "2023-11-07T05:31:56Z"
}
]
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "3025",
"Message": "EndDate cannot be before StartDate.",
"Errors": [
{
"Code": "3025",
"Message": "EndDate cannot be before StartDate."
}
]
}{
"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."
}
]
}Sales Invoices
List sales invoices
Lists sales invoices page by page.
GET
/
api
/
v1
/
sales-invoices
List sales invoices
curl --request GET \
--url https://api.noyax.com/api/v1/sales-invoices \
--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/sales-invoices");
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/sales-invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/sales-invoices"
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": {
"Page": 1,
"PageSize": 50,
"TotalCount": 128,
"Items": [
{
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CurrencyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"CustomerName": "<string>",
"Cancelled": true,
"CurrencyCode": "TRY",
"ShipmentDefinitionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Address": "<string>",
"CustomerTitle": "<string>",
"TaxNumber": "<string>",
"TaxOffice": "<string>",
"EInvoiceType": 2,
"InvoiceNumber": "FAT2026000125",
"DocumentNumber": "<string>",
"Date": "2026-09-21T10:30:00",
"Description": "<string>",
"CustomerCode": "C-0001",
"DueDays": 123,
"SharingCode": "<string>",
"ShipmentDefinitionCode": "<string>",
"DiscountTotal": 100,
"SubTotal": 900,
"VatTotal": 225,
"GrandTotal": 1350,
"Consolidated": true,
"PrintDescription": true,
"ApplyWithholding": true,
"WithholdingCode": "<string>",
"WithholdingNumerator": 123,
"WithholdingDenominator": 123,
"WithholdingTotal": 0,
"AdditionalTaxTotal": 225,
"ProfileId": "<string>",
"InvoiceTypeCode": "<string>",
"WithholdingTaxRate": 123,
"SocialSecurityRate": 123,
"MarketRate": 123,
"ReturnedInvoiceNumber": "<string>",
"ReturnedInvoiceDate": "2026-10-15",
"OrderReferenceNumber": "<string>",
"OrderReferenceDate": "2026-10-15",
"BranchNumber": "<string>",
"BranchTitle": "<string>",
"BranchAddress": "<string>",
"InvestmentIncentiveDocumentNumber": "<string>",
"InvestmentIncentiveDocumentDate": "2026-10-15",
"EnergyPeriodStart": "2023-11-07T05:31:56Z",
"EnergyPeriodEnd": "2023-11-07T05:31:56Z",
"DeliveryInfo": {
"DeliveryTerm": "<string>",
"TransportModeCode": 123,
"Country": "<string>",
"CityName": "<string>",
"CitySubdivisionName": "<string>",
"StreetName": "<string>",
"BuildingName": "<string>",
"BuildingNumber": "<string>",
"PostalZone": "<string>",
"TransportMeans": "<string>",
"DeclaredForCarriageValueAmount": 123,
"DeliveryInsuranceValue": 123
},
"PaymentMeans": [
{
"PaymentMeansCode": "<string>",
"PayeeFinancialAccountID": "<string>",
"CurrencyCode": "<string>"
}
],
"ReferencedDespatches": [
{
"ID": "<string>",
"IssueDate": "2023-11-07T05:31:56Z"
}
],
"CustomerIdentitySchemes": [
{
"SchemeID": "<string>",
"Value": "<string>"
}
],
"PublicSectorSpendingUnit": {
"BCP_Name": "<string>",
"BCP_VKN": "<string>",
"BCP_Country": "<string>",
"BCP_CityName": "<string>",
"BCP_CitySubdivisionName": "<string>"
},
"SgkInfo": {
"StartDate": "2023-11-07T05:31:56Z",
"EndDate": "2023-11-07T05:31:56Z",
"MukellefKodu": "<string>",
"MukellefAdi": "<string>",
"DosyaNo": "<string>",
"FaturaAltTipi": "<string>"
},
"AverageExchangeRate": 1,
"CreateDate": "2023-11-07T05:31:56Z",
"ModifyDate": "2023-11-07T05:31:56Z"
}
]
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "3025",
"Message": "EndDate cannot be before StartDate.",
"Errors": [
{
"Code": "3025",
"Message": "EndDate cannot be before StartDate."
}
]
}{
"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."
}
]
}Sales invoices are returned newest first and without their lines; use Get sales invoice for the lines.
To synchronize changes, pass your last synchronization time as
searchlooks in the invoice number, document number and customer name.- Invoices cancelled in Noyax are left out of the list; they can still be read by ID (
Cancelled: true). - Paging works like the other lists:
pagestarts at 1,pageSizeis at most 50.
Filters and sorting
All are optional and can be combined:| Parameter | Meaning |
|---|---|
startDate, endDate | Range on the document date, both inclusive. endDate cannot be before startDate (3025) |
customerCode | Only this customer’s documents. An unknown customer returns the matching “customer not found” code |
currencyCode | Only documents in this currency |
modifiedSince | Documents created or modified at or after the given date and time (ISO 8601). A document that was never modified counts by its creation time |
createdSince | Documents created at or after the given date and time |
sortBy | date (default, the document’s date and time), modifyDate (last change), createDate or number (document number). An invalid value returns 0011 |
sortDirection | desc (default, newest first) or asc. An invalid value returns 0012 |
modifiedSince and sort with sortBy=modifyDate&sortDirection=asc. Send the time in Turkey time without a time zone offset. Deleted documents no longer appear in the list, so they cannot be discovered this way.
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 |
|---|---|---|
0011 | 400 | sortBy is invalid |
0012 | 400 | sortDirection must be asc or desc |
0580 | 400 | A value given as text (a code or a name) matches more than one record; add the detail that tells them apart (for example City for a district, Country for a city) |
3006 | 400 | Customer not found or not visible to the user |
3025 | 400 | endDate cannot be before startDate |
3026 | 400 | The currency given in currencyCode was not found in the company |
Authorizations
Headers
Query Parameters
Response
OK