{"uid":"cap_Xk_4u7noru7vU0u_K9wwy","slug":"handel-allergen-check-ce1cc5f2","name":"Handel Allergen Check","description":"Returns what a product declares about allergens: the allergen tags, the trace warnings, the ingredients text in its original language, and the completeness of the record. The distinction it holds to throughout is between not declared and not present. The data come from volunteers and manufacturer submissions, so an empty allergen field means nobody entered one, and for somebody with an allergy that difference is the difference that matters — every absent allergen is therefore reported as not…","url":"https://handel.halowerk.com/v1/allergen-check","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_QNSXtNs6BX4LC05ZIdRk3","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":"Returns allergen declarations, trace warnings, ingredients text, and record completeness for a food product identified by barcode, explicitly distinguishing 'not declared' from 'not present'.","exampleAgentPrompt":"Can you check the allergen declarations for the product with barcode 5000118491121 — I need to know what allergens are listed, any trace warnings, and whether the record is complete or if some fields were never filled in?","exampleUseCases":[{"title":"Allergy-safe grocery shopping check","prompt":"I'm allergic to peanuts and tree nuts — can you scan barcode 8001120928603 and tell me what allergens are declared on the label, whether there are any trace warnings, and flag it clearly if the allergen field was never filled in at all?"},{"title":"E-commerce product listing compliance","prompt":"We're listing a new product with barcode 3017620422003 on our marketplace and need to show allergen info to customers — pull the allergen tags, trace warnings, and the original ingredients text, and let me know if the record looks complete or if anything is missing."},{"title":"School cafeteria ingredient audit","prompt":"Before we serve this item to students, can you look up barcode 4008400401621 and give me the full allergen declaration including any 'may contain' trace warnings, and tell me if the allergen data is actually present in the record or just absent because nobody entered it?"}],"resultDescription":"A structured response containing: declared allergen tags (e.g. gluten, milk, nuts), trace/may-contain warnings, the original-language ingredients text, and a completeness indicator for the record — with explicit flags distinguishing allergens that are 'not declared' (field was never submitted) from those confirmed 'not present'.","failureModes":["Barcode not found in Open Food Facts or product database — returns empty or null allergen fields with a not-found indicator","Allergen fields never submitted by volunteers or manufacturer — returned as 'not declared' rather than 'not present', which may be misread as safe","Ingredients text available only in a language the caller doesn't expect","Incomplete record with partial allergen data — completeness score is low but some fields are populated","Invalid or malformed barcode input — likely returns a validation error or empty result"],"whenToPreferThis":"Choose this endpoint when you specifically need allergen safety data — including the critical 'not declared vs not present' distinction — for a packaged food product identified by barcode. It is the right choice for allergy screening, compliance checks, and label auditing where a false negative (empty field misread as safe) would be dangerous. Prefer this over a general barcode lookup when allergen detail and record completeness are the primary concern rather than just product name or nutrition values.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:57.258Z","isFirstParty":false}