{"uid":"cap_Nw0eu4JYrjua_PmV5-bNN","slug":"handel-ingredient-decoder-9826fe35","name":"Handel Ingredient Decoder","description":"Returns the ingredient list of a product as a structured hierarchy including sub-ingredients, with each additive resolved to its E number and name, the percentage where declared, and the origin markers such as palm oil or vegan and vegetarian status as the record carries them.","url":"https://handel.halowerk.com/v1/ingredient-decoder","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"barcode":{"type":"string","maxLength":20,"minLength":8}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KSUxYb--i85MfcMxp3C50","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a product ingredient list into a structured hierarchy, resolving additives to E numbers, flagging percentages, and annotating origin markers like palm oil and vegan/vegetarian status.","exampleAgentPrompt":"Can you decode the ingredient list for this product — 'Water, Sugar, Modified Starch (E1442), Palm Oil, Natural Flavourings' — and tell me all the E numbers, whether it's vegan, and if palm oil is present?","exampleUseCases":[{"title":"Vegan product ingredient check","prompt":"I have the ingredient text from a snack bar: 'Oats, Glucose Syrup, Glycerol (E422), Palm Oil, Soy Lecithin (E322)' — can you decode it and tell me whether it's vegan, whether it has palm oil, and what each E number refers to?"},{"title":"Retailer label compliance audit","prompt":"We need to verify that our supplier's ingredient string — 'Wheat Flour (72%), Water, Yeast, Salt, Emulsifier (E471)' — is properly structured with percentages and all additives resolved to their official E names. Can you parse it into a hierarchy for us?"},{"title":"Consumer app additive lookup","prompt":"Decode the ingredients on this yoghurt label: 'Skimmed Milk, Cream, Sugar, Modified Maize Starch, Flavouring, Colour (Carmine E120)' — show me the full hierarchy, flag any palm oil or animal-derived additives, and tell me if it's vegetarian."}],"resultDescription":"A structured JSON hierarchy of ingredients and their sub-ingredients, where each additive is resolved to its E number and official name, declared percentages are preserved, and origin markers (palm oil presence, vegan status, vegetarian status) are annotated as carried in the source data.","failureModes":["Malformed or unparseable ingredient string returns an error indicating the text could not be decoded","Ambiguous additive names with no clear E number mapping may be returned unresolved or flagged as unknown","Very long or highly nested ingredient lists may result in incomplete hierarchy resolution","Missing percentage declarations in the source string will result in null percentage fields rather than estimated values","Non-standard regional additive naming conventions may not match the E number database"],"whenToPreferThis":"Choose this endpoint when you need a structured, machine-readable breakdown of a product ingredient list with additive resolution — especially when you need E numbers, sub-ingredient nesting, palm oil flagging, or vegan/vegetarian status in a single call. Prefer it over generic NLP parsers when food-label-specific semantics and additive databases are required. It complements the allergen and nutrition endpoints on the same platform for full product label analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:31:00.027Z","isFirstParty":false}