/api/items22

provide items of a category and related data

Parameters

(int) the category id to list items for. Use 0 to indicate all items that are marked as special offering (default). -1 indicates all items, regardless off their category. Results in big data and potential timeouts, use it only with max+scroll or noitems=1 🔗 group_id
(int) alternatively, the rubric id to list items for🔗 rubric_id
(int) alternatively, the subcategory id to list items for🔗 subgroup_id
(int) alternatively, a comma separated list of item ids
(int) alternatively, as admin, the packing station id to list items for🔗 packsid
(any value) dont include the items themselves, just their accompanying data (like units or tour limits)
(boolean) if 1, include all hidden items (which are otherwise skipped)
(int) a maximum nuber of records to be returned.
(int) scrolling offset. Use it together with max to implement result scrolling. If nothing was returned, you reached the end of the list.
(1 or 0) shuffle result
(int) if 1, utilize edge cache. use it to get fast responses. Caches are cleared at midnight, if not explicitly requested.<b>Dont use this, if you request sensitive data (like individual prices)</b>
(int) request that images are provided as data urls. The value can be between 20 and 150, it defines the px size of the image square.
(String) optionally define the response-format for this call. One of: compact (default) | compacts | full | fulls | json | md | html | js | openapi | yaml
(int) optionally force the API to check against the role (instead of silently not returning data). For guests or public access, the default is -1. 0 (regular customer) and above define the role for which the current session is expected to be authorized.

Response Types

Item

Item (v24) docs

A warehouse Item

Fields (71)
#FieldTypeDescriptionLinks
0idintInternal Id🔗 item_id
1namestringitem name
2pricedoubleitem base price
3unitstringitem base unit (plain text) (translatable)
4infotxtstringshort info text, Item teaser line
5categoryidintid of the warehouse category this item belongs to⬆ categoryid🔗 group_id
6vatdoubleitem vat percentage (0..100)
7refunddoublerefund value associated with that item (CHECKME)
8typeintItem type. 0: regular item that comes in piece, -1 regular item with a weighted unit, other ids: see item type documentation
9hiddenboolitems may be (temporarily) hidden, as such not to be part of the offering
10referencePricedoublereference price: price/referenceAmount
11thumbnailCodestringif set, a thumbnail exists. Depending on the request (parameter ?img=b64), either a data URL or a image hashCode is returned. In the latter case, the image can be fetched by BASEURL/t.px?PARAMS (see docu)
12hasLongInfobooltrue if a long info exists. Fetch it separately
13preorderPossiblebooltrue if the item can be pre ordered for a delivery later than the current selected delivery date
14infoReferenceintif > 0, where to get more information. 1: Ecoinform, 2: Datanature
15orderPeriodEnddateif set, date when the ordering period ends.
16orderPeriodStartdateif set, date when the ordering period starts.
17deliveryPeriodStartdateif set, date when the delivery period starts.
18deliveryPeriodEnddateif set, date when the delivery period ends.
19weightedbooltrue if the item is weighted (and thus, the price might change slightly)
20preOrderOnOrderStopboolaka orderStopNew. if true , the item shall be pre-ordered the following possible delivery day
21pointerstringIf the type is not 0, this is a pointer item and it points to the target with that id. What kind of target is defined by the item type (dee reference). if item type is 27 (href link), its the URL this pointer points to. For type 0 , its the unit id reference.
22specialOfferbool(aka flag2), if true, this item shall be highlighted as special offer
23searchTermsstringalternative search terms for this item
24referenceUnitstringreference unit (translatable)
25imageCodestringif set, a (big) image) exists. Depending on the request (parameter ?img=b64), either a data URL or a image hashCode is returned. In the latter case, the image can be fetched by BASEURL/b.px?PARAMS (see docu)
26packnamestringalternative internal name. For vouchers, this field transports the semi-secret voucher code.
27verbandstringThe main (organic) certification association. These are well-known codes
28originIdintreference to the geografic origin (aka Herkunft) of that item.
29isRegionalbooltrue if this item is sourced regionally
30AmountMindoubleif > 0, minimum amount of this item when ordered
31AmountMaxdoubleif > 0, maximum amount of this item when ordered
32AmountDefdoubleif > 0, default amount of this item when picked in a UI without amount selection options or as initial value when placed into the cart
33AmountStepdoubleif > 0, the increment and decrement when plus or minus buttons are used to modify the order amount
34imageCountintnumber of extra images available for this product. Add the index (1..9) to the proxy call like BASEURL/b1.px?...
35lastPricedoubleif > 0, last price of this item, set by the last price detection mechanism
36labelsint[]list of label ids that apply to this item
37hasRelatedbooltrue if this item has referenced items (transported in Object RelatedItem)
38producerIdintif > 0, reference to the producer of that item.
39hasLG5boolhas data for the label group 5 (Nutrition data). Fetch them separately if needed.
40saleLeftdoubleif -1, this item is not limited by a saleout. If 0, item was just sold out. If > 0, it tells the number of still available items (in item unit)
41certificatestringorganic monitoring certifiation code
42availablebooltrue if this item is available for purchase (aka legacy protection)
43unitsstringcleartext unit name (translatable)
44packageCodeintRefund type: 0: unset, 1: One-Way, 2: Reusable (aka Mehrweg-Pfand), 3: no refund
45euOriginstringcan be one of the three EU source labels (DOOR) PGI (1), TSG (2), PDO (0)
46alcoholCodeintAlcohol code: 0: unset, 1: Alcohol, 2: Non-Alcohol
47tradingClassstringaka Handelsklasse, german trade quality class (applicable for regular items type 0 only)
48seasonalbooltrue if this item is seasonal (not always available at fullfillment time)
49packingStationIdintreference to a packing station. A packing station may imply limits when ordering.
50weightdoubleweight of this item in kilograms
51referenceUnitFactordoubleif > 0, how to translate the packaging unit (field unit) into the reference unit (for displaying the reference price)
52maxDiscountdoublemaximum discount that can be applied for this item (<=100)
53unitHintstringhint to be displayed next to the unit string. PCG liver does only use ISO Units so eny extra hint (like '6-pack' is expected here)
54bulkPricedoublebulk price for this item. If > 0, this item has a discounted price if the buldAmount is exceeded
55bulkAmountdoublethis item has a discounted price if the buldAmount is exceeded
56bulkPriceReferencedoublereference price in reference units (bulkprice / refAmount)
57noSubscriptionbooltrue if this item is not available for subscription
58dateBorderdateThis record shows values relevant for the sessions selected delivery date. Some field may change after this date
59brandcodestringbrand shortcode of the item
60infoReferencePointersstringif enabled, shows pointers to external information (ean, ecoinform, datanature
61producerNamestringname of the producer of that item (translatable)
62saleTypeint(aka Abverkauf), there are several saleout types, see the documentation. 0: no sale, 1: regular (forever) sale
63brandNamestringname of the brand of that item (through Item/Datanature (translatable)
64partnerIdintif > 0, it is the Id of a partner that handles fulfillment
65locationHintstringLocation information in a physical store. May be used to creat creative shop ideas. (translatable)
66packsidintinternal packstation id. Only provided if the request comes with admin permissions
67packseqintinternal packing sequence number. Only provided if the request comes with admin permissions
68isBiobooltrue if the verband is an EU-certified organic association; the EU-Bio logo should be shown alongside the org logo
69pcgIdintinternal PCG backend id. Requires. Provided only if the caller has sufficient permissions
70bestBeforeDaysintbest-before days (aka MHD-days): the expected number of days one can assume from the moment of delivery. 0 if not maintained

Data (25 records)

idnamepriceunitinfotxtcategoryidvatrefundtypehiddenreferencePricethumbnailCodehasLongInfopreorderPossibleinfoReferenceorderPeriodEndorderPeriodStartdeliveryPeriodStartdeliveryPeriodEndweightedpreOrderOnOrderStoppointerspecialOffersearchTermsreferenceUnitimageCodepacknameverbandoriginIdisRegionalAmountMinAmountMaxAmountDefAmountStepimageCountlastPricelabelshasRelatedproducerIdhasLG5saleLeftcertificateavailableunitspackageCodeeuOriginalcoholCodetradingClassseasonalpackingStationIdweightreferenceUnitFactormaxDiscountunitHintbulkPricebulkAmountbulkPriceReferencenoSubscriptiondateBorderbrandcodeinfoReferencePointersproducerNamesaleTypebrandNamepartnerIdlocationHintpacksidpackseqisBiopcgIdbestBeforeDays
8412 →create2 →item1Grill & Dip Burger Sauce3.65Stück98 →items21 →items23 →items20 →items22 ⬆7.00.00false18.2514c914d0falsefalse12027-11-221899-12-302022-08-012027-11-22falsefalse3falsel835e11e4Grill & Dip Burger Sauce100% Bioanbau37false0.00.01.00.000.0[853, 852, 890, 887, 896, 611]false290true-1.0DE-ÖKO-005trueStück00false40.3610.2100.00.00.00.0false2022-08-01ZWEean:4019736015277, ecoinform:null, datanature:0cc237e2-a19b-4cac-b1f9-7785ba8c872eZwergenwiese0Zwergenwiese000false00
8483 →create2 →item1Jalapeno Mayonnaise 250ml3.85StückMayonnaise mit würzig scharfen Jalapeno Stückchen98 →items21 →items23 →items20 →items22 ⬆7.00.00false15.414b314ccfalsefalse12027-11-221899-12-302025-04-262027-11-22falsefalse3falsel833111f4Jalapeno Mayonnaise 250ml100% Bioanbau37false0.00.01.00.000.0[844, 853, 611]false845true-1.0DE-ÖKO-006trueStück30false40.3780.25100.00.00.00.0false2026-09-26MKSean:4260112296807, ecoinform:null, datanature:dd31d850-465b-4ef2-b796-f5113716e766Münchner Kindl Senf0Münchner Kindl Senf000false00
8399 →create2 →item1Tomaten passiert Rosso Gentile2.85Stück98 →items21 →items23 →items20 →items22 ⬆7.00.00false0.0falsefalse02027-11-221899-12-302026-09-262027-11-22falsefalse3falseTomaten passiert Rosso Gentile100% Bioanbau5false0.00.01.00.000.0[]false937false-1.0DE-ÖKO-005trueStück00false4-1.01.0100.00.00.00.0false2026-09-26CMPean:8017356001041, ecoinform:null, datanature:CMP0000false00
6837 →create2 →item1Peperoncino Confit4.8140g98 →items21 →items23 →items20 →items22 ⬆7.00.00false34.2861a4148dfalsefalse12027-11-221899-12-302024-02-102027-11-22falsefalse917false1kg71cd11b4Peperoncino Confit100% Bioanbau5false0.00.01.00.000.0[896, 611]false312true-1.0DE-ÖKO-005true140g30false40.2670.14100.00.00.00.0false2026-09-26SELean:8018759001942, ecoinform:null, datanature:174848a1-90f1-4f06-acf2-6a4709df3d29LaSelva0LaSelva000false00
8454 →create2 →item1Feigen Senf 125ml3.75Stück98 →items21 →items23 →items20 →items22 ⬆7.00.00false30.0bb1488falsefalse12027-11-221899-12-302025-03-292027-11-22falsefalse3falsel712811aeFeigen Senf 125ml100% Bioanbau37false0.00.01.00.000.0[853, 896, 611]false845true-1.0DE-ÖKO-006trueStück00false40.2710.125100.00.00.00.0false2026-09-26MKSean:4260112294872, ecoinform:null, datanature:ab6da318-c2ec-4388-988c-3e5f78d3a3eeMünchner Kindl Senf0Münchner Kindl Senf000false00
8363 →create2 →item1Hackfleisch bolognese 400ml10.8Stückmit Tomatensauce 100% kbA,Tagwerk98 →items21 →items23 →items20 →items22 ⬆7.00.00false27.0be1a1cfdfalsefalse22027-11-221899-12-302022-09-102027-11-22falsefalse3falselbe0e1cf9Hackfleisch bolognese 400ml100% Bioanbau64false0.00.01.00.000.0[846]false947false-1.0DE-ÖKO-005trueStück30IIfalse40.30.4100.00.00.00.0false2026-09-26FMBean:4036716008654, ecoinform:null, datanature:c5ea91c0-ffe3-463a-9fa4-0418fc0b69d1FMB0000false00
8355 →create2 →item1Bologneseveget. 350g Tomatens.3.55Stück100% kbA, Zwergenwiese98 →items21 →items23 →items20 →items22 ⬆7.00.00false10.14318b148afalsefalse12027-11-221899-12-302006-01-012027-11-22falsefalse3false1kg71f411a7Bologneseveget. 350g Tomatens.100% Bioanbau37false0.00.01.00.000.0[852, 855, 896, 611]false290true-1.0DE-ÖKO-005trueStück30IIfalse40.5830.35100.00.00.00.0false2026-09-26ZWEean:4019736000679, ecoinform:null, datanature:9b9329b7-829a-45a9-ba68-ebc05eb2ad5cZwergenwiese0Zwergenwiese000false00
8354 →create2 →item1SpaghettisauceSalsaprontaTomat3.15340g340g, Italien, Naturland98 →items21 →items23 →items20 →items22 ⬆7.00.00false9.265148314ccfalsefalse12027-11-221899-12-302006-01-012027-11-22falsefalse56false1kg831e11f2SpaghettisauceSalsaprontaTomat100% Bioanbau5false0.00.01.00.000.0[852, 896, 611]false312true-1.0DE-ÖKO-005true340g30IIfalse40.5410.34100.00.00.00.0false2026-09-26SELean:8018759000037, ecoinform:null, datanature:bcdf3803-9e2b-4c41-b533-81f99666f378LaSelva0LaSelva000false00
8426 →create2 →item1Asia Sauce 250ml4.45250mlByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.8926b1c46falsefalse12027-11-221899-12-302024-08-032027-11-22falsefalse21falsel925f1c42Asia Sauce 250ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013true250ml00IIfalse40.3170.25100.00.00.00.0false2026-09-26BYOean:4018462195000, ecoinform:null, datanature:62fb195f-95da-4d29-8890-c14d11c17e67BYODO0Byodo000false00
8431 →create2 →item1Curry Mango Sauce 250ml4.45StückByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.8ae6d1d63falsefalse12027-11-221899-12-302023-06-172027-11-22falsefalse3falselae721d68Curry Mango Sauce 250ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013trueStück00IIfalse40.4750.25100.00.00.00.0false2026-09-26BYOean:4018462193006, ecoinform:null, datanature:56d99ed1-d378-4810-9758-34e6b97685cdBYODO0Byodo000false00
8429 →create2 →item1Knoblauch Sauce 250ml4.45StückByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.8ac2d1d1dfalsefalse12027-11-221899-12-302023-01-012027-11-22falsefalse3falselac321d22Knoblauch Sauce 250ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013trueStück00IIfalse40.4650.25100.00.00.00.0false2026-09-26BYOean:4018462192009, ecoinform:null, datanature:a9010fbe-ea69-4016-ae52-2c586e7eb3e3BYODO0Byodo000false00
8434 →create2 →item1Sojasauce Shoyu 0,255.6250mlYakso98 →items21 →items23 →items20 →items22 ⬆7.00.00false22.491ef1c37falsefalse12027-11-221899-12-302011-08-012027-11-22falsefalse21falsel91ef1c37Sojasauce Shoyu 0,25956false0.00.01.00.000.0[]false994false-1.0DE-ÖKO-005true250ml30IIfalse40.250.25100.00.00.00.0false2026-09-26YAKean:5400313009472, ecoinform:null, datanature:9b1be935-fe98-44f7-95db-6ace3ca60862YAK0Yakso000false00
8589 →create2 →item1Tomaten Ketchup 500ml5.1StückByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false10.29f871d03falsefalse12027-11-221899-12-302010-03-292027-11-22falsefalse3falsel9fb81d11Tomaten Ketchup 500ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013trueStück00IIfalse40.8720.5100.00.00.00.0false2026-09-26BYOean:4018462157008, ecoinform:null, datanature:acf9d655-b9eb-474b-80ec-2132c28a0ec3BYODO0Byodo000false00
8591 →create2 →item1Hot Ketchup 500ml5.6StückByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false11.297f01c92falsefalse12027-11-221899-12-302024-03-022027-11-22falsefalse3falsel97e41c8eHot Ketchup 500ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013trueStück00IIfalse40.8620.5100.00.00.00.0false2026-09-26BYOean:4018462157206, ecoinform:null, datanature:6a3e4ea7-24e2-4184-92ff-82d0a78706b9BYODO0Byodo000false00
8450 →create2 →item1Senf süß 200 ml3.4StückBioland, Byodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.094a71c70falsefalse12027-11-222024-03-282006-01-012027-11-22falsefalse3falsel94c61c7eSenf süß 200 ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013trueStück00IIfalse40.3980.2100.00.00.00.0false2026-09-26BYOean:4018462161609, ecoinform:null, datanature:513887fb-1759-4c10-84c5-56cafea874f0BYODO0Byodo000false00
8458 →create2 →item1Dijon Senf 125ml3.95125ml100% kbA, Byodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false31.699321cd4falsefalse12027-11-221899-12-302006-01-012027-11-22falsefalse48falsel99371cd9Dijon Senf 125ml100% Bioanbau8false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013true125ml00IIfalse40.2480.125100.00.00.00.0false2026-09-26BYOean:4018462161906, ecoinform:null, datanature:9faac588-4150-40b9-a131-ef033d978f26BYODO0Byodo000false00
8448 →create2 →item1Senf mittelscharf 200ml2.6200mlBioland, Byodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false13.0b4591d5afalsefalse12027-11-221899-12-302006-01-012027-11-22falsefalse19falselb45f1d61Senf mittelscharf 200ml100% Bioanbau37false0.00.01.00.000.0[853, 914, 896, 611]false279true-1.0DE-ÖKO-013true200ml00IIfalse40.3820.2100.00.00.00.0false2026-09-26BYOean:4018462161708, ecoinform:null, datanature:3946ff82-2627-4419-a1c6-2002eea36f53BYODO0Byodo000false00
8484 →create2 →item1Mayonnaise4.45250ml100% kbA, Byodo, 80% Fett98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.893541c50falsefalse12027-11-221899-12-302023-01-012027-11-22falsefalse21falsel93481c4cMayonnaise100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013true250ml00IIfalse40.410.25100.00.00.00.0false2026-09-26BYOean:4018462158005, ecoinform:null, datanature:f3a0945b-0615-403a-b6e6-67b40130c0eaBYODO0Byodo000false00
8482 →create2 →item1Kräuterremoulade 250ml4.45250ml100% kbA, Byodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.897ae1c74falsefalse12027-11-221899-12-302023-01-012027-11-22falsefalse21falsel97a21c70Kräuterremoulade 250ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013true250ml00IIfalse40.410.25100.00.00.00.0false2026-09-26BYOean:4018462158708, ecoinform:null, datanature:f9c14a9a-eb5c-4aa3-9c77-4f75278a341bBYODO0Byodo000false00
8452 →create2 →item1Meerrettich 100g4.15100gBayern, Bioland, Byodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false41.5acce1d68falsefalse12027-11-221899-12-302006-01-012027-11-22falsefalse3false1kgacd31d6dMeerrettich 100g100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013true100g00IIfalse40.2120.1100.00.00.00.0false2026-09-26BYOean:4018462160558, ecoinform:null, datanature:4e6da4ce-2e28-4707-98c1-ecbf94915d22BYODO0Byodo000false00
6827 →create2 →item1Tomatenpolpa Fine 690g3.4Stückfeinstückig mit Meersalz98 →items21 →items23 →items20 →items22 ⬆7.00.00false4.928135914befalsefalse12027-11-222024-03-282021-01-012027-11-22falsefalse3falseTomaten püriert passiert Tomatenpüree1kg823711e2Tomatenpolpa Fine 690gEG-Kontrolliert5false0.00.01.00.000.0[896, 611]false312true-1.0DE-ÖKO-005trueStück30IIfalse41.0320.69100.00.00.00.0false2026-09-26SELean:8018759000815, ecoinform:null, datanature:4849b327-a27d-4e33-afcd-fa646c24fc73LaSelva0LaSelva000false00
8360 →create2 →item1Tomatenpüree fein 425g2.6StückItalien,La Selva98 →items21 →items23 →items20 →items22 ⬆7.00.00false6.1031771493falsefalse12027-11-221899-12-302021-01-012027-11-22falsefalse3false1kg71a211b2Tomatenpüree fein 425gEG-Kontrolliert5false0.00.01.00.000.0[896, 611]false312true-1.0DE-ÖKO-005trueStück30IIfalse40.50.426100.00.00.00.0false2026-09-26SELean:8018759003786, ecoinform:null, datanature:2e51ccce-5dfd-4c3f-9755-95930604f5f8LaSelva0LaSelva000false00
8362 →create2 →item1Salsa Piccante 340g3.15StückLa Selva98 →items21 →items23 →items20 →items22 ⬆7.00.00false9.2656a1489falsefalse12027-11-221899-12-302023-03-312027-11-22falsefalse3false1kg70d711aaSalsa Piccante 340g100% Bioanbau5false0.00.01.00.000.0[852, 896, 611]false312true-1.0DE-ÖKO-005trueStück30IIfalse41.060.34100.00.00.00.0false2026-09-26SELean:8018759000907, ecoinform:null, datanature:e936ae4f-a5df-46be-8edd-965a4af6b681LaSelva0LaSelva000false00
8427 →create2 →item1Barbecue Sauce 250 ml4.45StückByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false17.892481c87falsefalse12027-11-221899-12-302026-02-282027-11-22falsefalse3falsel923f1c82Barbecue Sauce 250 ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-005trueStück00IIfalse40.3170.25100.00.00.00.0false2026-09-26BYOean:4018462196007, ecoinform:null, datanature:24bec0d6-d640-4912-93e6-871b10af7e37BYODO0Byodo000false00
8588 →create2 →item1Gewürzketchup 500ml5.6StückByodo98 →items21 →items23 →items20 →items22 ⬆7.00.00false11.2a2691ccbfalsefalse12027-11-221899-12-302010-03-292027-11-22falsefalse3falsela26e1cd0Gewürzketchup 500ml100% Bioanbau37false0.00.01.00.000.0[]false279false-1.0DE-ÖKO-013trueStück00IIfalse40.8620.5100.00.00.00.0false2026-09-26BYOean:4018462157510, ecoinform:null, datanature:bc9170b0-f9fa-440d-a897-7a00712ece32BYODO0Byodo000false00