Check a product against a user's allergen list API

Given a product barcode and a list of allergens the user must avoid, this checks the product's DECLARED allergens, its 'may contain' traces, and its ingredient text, returning a DERIVED verdict (avoid / caution / clear / unknown) with the exact matches in each tier. The MORE: a personalized go/no-go decision instead of raw allergen tags an agent would have to reconcile itself. Answers 'is this product safe for a peanut allergy', 'does this barcode contain milk', 'check this food against my allergens', 'can someone allergic to soy eat this'.

Price$0.01per request

MethodPOST

Route/v1/data/food-allergen-check

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

datafoodallergenbarcodefood-safetydietaryhealthcheck

API URLhttps://x402.hexl.dev/v1/data/food-allergen-check

Integration docs

Example request

{
  "barcode": "3017620422003",
  "allergens": [
    "milk",
    "peanuts",
    "soy"
  ]
}

Example response

{
  "barcode": "3017620422003",
  "name": "Nutella",
  "brand": "Nutella, Yum yum",
  "verdict": "avoid",
  "declaredMatches": [
    "milk",
    "peanuts",
    "soy"
  ],
  "traceMatches": [],
  "ingredientHits": [],
  "productAllergens": [
    "milk",
    "nuts",
    "soybeans"
  ],
  "productTraces": [],
  "checkedAllergens": [
    "milk",
    "peanuts",
    "soy"
  ],
  "notes": "Product DECLARES milk, peanuts, soy as (an) allergen(s) you listed.",
  "disclaimer": "Crowd-sourced data may be incomplete or out of date. ALWAYS verify the physical label; this check is an aid, not a substitute for reading the package."
}

Input schema

{
  "type": "object",
  "required": [
    "barcode",
    "allergens"
  ],
  "properties": {
    "barcode": {
      "type": "string",
      "pattern": "^\\d{6,14}$",
      "description": "Product barcode (EAN/UPC)."
    },
    "allergens": {
      "type": "array",
      "minItems": 1,
      "maxItems": 30,
      "items": {
        "type": "string"
      },
      "description": "Allergen names to avoid, e.g. ['peanuts','milk','soy']."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}