supplemental.pl — EU/PL food law

Full-text search of supplemental.pl knowledge articles on EU/PL food law (health claims, novel food, supplements, labelling, CJEU case law) in Polish, English or German. Returns titles, URLs, dates, summaries and language versions.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Search terms, e.g. \"novel food NMN\" or \"oświadczenia zdrowotne witamina D\"."
    },
    "lang": {
      "type": "string",
      "enum": [
        "pl",
        "en",
        "de"
      ],
      "description": "Response language. Default: en."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Max results (default 5)."
    }
  },
  "required": [
    "query"
  ]
}

Return one supplemental.pl knowledge article by URL or slug: summary, headings, a text excerpt, legal references named in it and its PL/EN/DE versions. Pass lang to get another language version.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 3,
      "maxLength": 400,
      "description": "Article URL on supplemental.pl or its slug."
    },
    "lang": {
      "type": "string",
      "enum": [
        "pl",
        "en",
        "de"
      ],
      "description": "Response language. Default: en."
    }
  },
  "required": [
    "url"
  ]
}

Look up a nutrient/substance in the official EU Register of nutrition and health claims (European Commission data, refreshed weekly). Shows whether each claim is Authorised, Non-authorised or Revoked, its conditions of use, the EFSA question and the legal act.

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Nutrient or substance (English or Latin), e.g. \"vitamin C\", \"glucomannan\"."
    },
    "claim_text": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional words of the claim/function, e.g. \"immune system\"."
    },
    "status": {
      "type": "string",
      "enum": [
        "all",
        "authorised",
        "non_authorised",
        "revoked"
      ],
      "description": "Default: all."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "lang": {
      "type": "string",
      "enum": [
        "pl",
        "en",
        "de"
      ],
      "description": "Response language. Default: en."
    }
  },
  "required": [
    "substance"
  ]
}

Look up a food or ingredient in the EU Novel Food Catalogue (European Commission data, refreshed weekly): status per part/form (Novel food, Not novel in food, Not novel in food supplements, Authorised novel food, consultation request), with links to Reg. 2015/2283 and the Union list.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Ingredient name (Latin, English or common name), e.g. \"Withania somnifera\", \"NMN\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "lang": {
      "type": "string",
      "enum": [
        "pl",
        "en",
        "de"
      ],
      "description": "Response language. Default: en."
    }
  },
  "required": [
    "name"
  ]
}

Match an ingredient (and optional dose) against Reg. 432/2012 authorised claims and the SANCO/11074/2013 botanical list via C.L.A.I.M.S. (FOODLAW.ai). Botanical claims are always returned as regulatory_status "on_hold" (not authorised).

{
  "type": "object",
  "properties": {
    "substance": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Ingredient (Latin, English or Polish)."
    },
    "dose": {
      "type": "string",
      "maxLength": 40,
      "description": "Optional dose, e.g. \"300 mg\"."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "pl"
      ]
    }
  },
  "required": [
    "substance"
  ]
}

Fetch one claim from C.L.A.I.M.S. by its numeric ID (from search_claims_foodlaw). Botanicals are always "on_hold".

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "minimum": 1
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "pl"
      ]
    }
  },
  "required": [
    "id"
  ]
}

Step-by-step procedure for notifying a food supplement to the Polish Chief Sanitary Inspectorate (GIS, Art. 29–30 of the Food and Nutrition Safety Act), from the supplemental.pl article. A GIS notification is not a novel food authorisation.

{
  "type": "object",
  "properties": {
    "lang": {
      "type": "string",
      "enum": [
        "pl",
        "en",
        "de"
      ],
      "description": "Response language. Default: en."
    }
  }
}

Deterministic nutrition calculation for a recipe (no AI): energy and nutrients per 100 g, micronutrients with %NRV, candidate nutrition claims (withheld if any ingredient is unresolved), allergens and QUID hints. Ingredient lines with mass or volume, e.g. "mąka pszenna 500 g", "milk 200 ml". Max 20 calculations per user per day.

{
  "type": "object",
  "properties": {
    "ingredients": {
      "type": "array",
      "minItems": 1,
      "maxItems": 40,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 120
      },
      "description": "One ingredient per item, with quantity and unit (g, kg, mg, ml, l)."
    },
    "product_name": {
      "type": "string",
      "maxLength": 120
    },
    "product_form": {
      "type": "string",
      "enum": [
        "solid",
        "liquid"
      ],
      "description": "Default solid."
    },
    "mass_loss_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 90,
      "description": "Mass loss during processing (e.g. baking), %."
    },
    "lang": {
      "type": "string",
      "enum": [
        "pl",
        "en",
        "de"
      ],
      "description": "Response language. Default: en."
    }
  },
  "required": [
    "ingredients"
  ]
}