List of products
List your products, 50 per page by default. OSS tax products are not listed; they are in GET /account → data.relations.ossProductTaxes.
query Parameters
per_pageinteger · min: 1 · max: 250Results per page, maximum 250. The default depends on the endpoint: 25 for invoices and contacts, 50 for products, 20 for payments, purchases and tags, 15 for OCP links. Responses carry
links.next(null on the last page) andmeta.current_page/meta.last_page; request the next page withpage=<n>.Example: 100pageinteger · min: 1The page to return.
has_stockstringOnly products that track stock (any value).
stock_lessnumberOnly products with stock below this number.
stock_greaternumberOnly products with stock above this number.
tag_idintegerOnly products with this tag id.
Headers
Acceptstringapplication/json
Responses
OK
dataobject[]linksobjectmetaobject
Create a new product
Create a product or service. Open the request body's Examples dropdown for a minimal product and a fully described service.
Headers
Acceptstringapplication/json
Request Body
namestring · maxLength: 255 · requiredRequired. Product or service name.
unitPricenumber · min: 0 · requiredRequired. Price per unit. With
isVatIncluded: trueit includes VAT;netUnitPricein the response is the price before VAT. A comma decimal ("12,50") is accepted.isVatIncludedboolean · requiredRequired. Whether
unitPriceincludes VAT.defaultVatIdinteger · requiredRequired. A VAT id from
GET /account→data.relations.vats.
nameSecstring · maxLength: 255Name in the second language (English documents).
descriptionstring · maxLength: 2000descriptionSecstring · maxLength: 2000Description in the second language.
skustring · maxLength: 100Your product code, unique in your account (422 if taken). Not returned in responses.
measurement_unitinteger · min: 1 · max: 12Default unit, 1–12 (same values as
measurementUnitinPOST /invoices).withStockbooleanTrack stock for this product.
stocknumber · min: 0activebooleantagsstring[]Tag names; missing tags are created.
charsobject[]Optional myDATA mapping for this product, overriding the account defaults (Settings → myData). Ask your accountant which classifications apply. One entry per myDATA category:
elpCategoryis the category name (the invoice type'smydataDefaultType, e.g. "Τιμολόγιο Παροχής Υπηρεσιών");mappinghas one row per contact type ("1"domestic,"2"EU,"3"outside the EU) withmydataCategorySelected,mydataTypeSelectedand, for 0% VAT,vatExemptionCat. Entries withoutelpCategoryare dropped. Not returned in responses.isServicebooleanA service rather than a product (dynamic OCP links use it to pick the document type).
timiAgorasnumber · min: 0Purchase price.
Responses
Created.
dataobject
Update a product
Update a product.
PUT replaces the product: left out,
withStockturns off and the product's myDATA mapping (chars) is removed. Send them again to keep them. Sending the product's ownskuis fine.
path Parameters
idstring · pattern:^[0-9]+· requiredThe product's ID
Example: 124
Headers
Acceptstringapplication/json
Request Body
namestring · maxLength: 255 · requiredRequired. Product or service name.
unitPricenumber · min: 0 · requiredRequired. Price per unit. With
isVatIncluded: trueit includes VAT;netUnitPricein the response is the price before VAT. A comma decimal ("12,50") is accepted.isVatIncludedboolean · requiredRequired. Whether
unitPriceincludes VAT.defaultVatIdinteger · requiredRequired. A VAT id from
GET /account→data.relations.vats.
nameSecstring · maxLength: 255Name in the second language (English documents).
descriptionstring · maxLength: 2000descriptionSecstring · maxLength: 2000Description in the second language.
skustring · maxLength: 100Your product code, unique in your account (422 if taken). Not returned in responses.
measurement_unitinteger · min: 1 · max: 12Default unit, 1–12 (same values as
measurementUnitinPOST /invoices).withStockbooleanTrack stock for this product.
stocknumber · min: 0activebooleantagsstring[]Tag names; missing tags are created.
charsobject[]Optional myDATA mapping for this product, overriding the account defaults (Settings → myData). Ask your accountant which classifications apply. One entry per myDATA category:
elpCategoryis the category name (the invoice type'smydataDefaultType, e.g. "Τιμολόγιο Παροχής Υπηρεσιών");mappinghas one row per contact type ("1"domestic,"2"EU,"3"outside the EU) withmydataCategorySelected,mydataTypeSelectedand, for 0% VAT,vatExemptionCat. Entries withoutelpCategoryare dropped. Not returned in responses.isServicebooleanA service rather than a product (dynamic OCP links use it to pick the document type).
timiAgorasnumber · min: 0Purchase price.
Responses
The updated product.
dataobject