Halal or Not

Check an ingredients list. Takes the ingredients exactly as printed on the pack. Returns an overall verdict, a verdict for each school, and every flagged ingredient with the reason.

{
  "type": "object",
  "properties": {
    "ingredients": {
      "type": "string",
      "description": "Ingredients list as printed, comma separated."
    },
    "context": {
      "type": "string",
      "enum": [
        "food",
        "cosmetic",
        "medicine"
      ],
      "default": "food",
      "description": "'cosmetic' for products used on the skin, 'medicine' for medicines and supplements; these change how alcohol, carmine and necessity are treated."
    }
  },
  "required": [
    "ingredients"
  ],
  "additionalProperties": false
}

Check a product by barcode. Looks the barcode up in Open Food Facts, then Open Beauty Facts, and checks its ingredients.

{
  "type": "object",
  "properties": {
    "barcode": {
      "type": "string",
      "description": "EAN-13, EAN-8 or UPC barcode digits."
    }
  },
  "required": [
    "barcode"
  ],
  "additionalProperties": false
}

Find products by name and check them. Searches Open Food Facts by name or brand (for example 'Haribo Starmix') and returns up to five matches, each with a verdict, plus a 'say' line for the best match. Where a brand states the source of an ingredient its label leaves unnamed (Haribo: pork gelatine in its standard UK range), that statement decides it and is quoted in brand_statement.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "A product, brand or barcode to look up, for example Haribo Starmix or 5000159484695."
    },
    "country": {
      "type": "string",
      "default": "united-kingdom",
      "description": "Open Food Facts country slug, for example united-kingdom, united-states, france. 'world' means no filter. Also picks the Amazon store for halal versions (amazon.co.uk for the UK and Ireland)."
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Explain one ingredient or E-number. For example 'E471', 'carmine', 'prawns', 'whey' or 'alcohol denat'. Returns the verdict for each school and the reasoning.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The ingredient or E-number, for example E471, carmine, gelatin or alcohol denat."
    },
    "context": {
      "type": "string",
      "enum": [
        "food",
        "cosmetic"
      ],
      "description": "Whether the ingredient is in food or a cosmetic. Defaults to food."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Is this stock halal? Screens a US-listed stock via Mizan: first the business (each standard's excluded industries), then the AAOIFI, Dow Jones Islamic, S&P Shariah and MSCI Islamic debt screens. A company name also works (nvidia, philip morris). Links to halal alternatives in the same industry.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "A US stock ticker, for example AAPL or TSLA."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

Ask any 'is it halal' question. Covers money (savings, credit cards, mortgages, BNPL, insurance, pensions, trading), crypto, medicine, food and drink, and everyday life (music, dogs, tattoos, nail polish, smoking, games, photos, jobs). Returns the verdict, the main scholarly views and halal alternatives. Also recognises single ingredients and E-numbers.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "The question in plain words, for example 'Is a credit card halal?'"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Is this fund, ETF or pension fund halal? Recognises Shariah funds by name or ticker. For other US-registered funds and ETFs, reads the latest SEC holdings report and screens every holding by industry and debt. UK-listed ETFs (VUSA, CSPX, VWRL, SWDA, EQQQ, ISF and others) and fund names (Vanguard S&P 500, FTSE 100 tracker, LifeStrategy) are answered through a US fund tracking the same index, or from what the index holds, with UK Shariah options.

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Fund or ETF ticker (VOO, QQQ, SPUS) or a Shariah fund name."
    }
  },
  "required": [
    "ticker"
  ],
  "additionalProperties": false
}

Is this cryptocurrency halal? Classifies a coin by what it does (lending, gambling, meme, stablecoin, staking, general-purpose) and gives the scholarly views on crypto and on how it's used.

{
  "type": "object",
  "properties": {
    "coin": {
      "type": "string",
      "description": "Coin name or symbol, for example bitcoin, ETH, AAVE."
    }
  },
  "required": [
    "coin"
  ],
  "additionalProperties": false
}

Is this medicine halal? Reads a medicine's active and inactive ingredients from its US label (openFDA) and flags gelatine, alcohol, pig-derived enzymes and heparin. The headline and say line lead with the ruling on necessity, so nobody stops a prescribed medicine; the ingredient reading follows (ingredient_headline, verdict)

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Brand or generic name."
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Today's prayer times for a place, with both Asr times and Ramadan suhoor and iftar. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name, for example London or Chicago, IL."
    },
    "lat": {
      "type": "number",
      "description": "Latitude of the place, in decimal degrees. Goes with lon instead of city."
    },
    "lon": {
      "type": "number",
      "description": "Longitude of the place, in decimal degrees. Goes with lat instead of city."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "The day, YYYY-MM-DD. Defaults to today."
    },
    "method": {
      "type": "string",
      "enum": [
        "isna",
        "mwl",
        "umm_al_qura",
        "egypt",
        "karachi",
        "moonsighting"
      ],
      "description": "Calculation method: isna (North America), mwl (Muslim World League), umm_al_qura, egypt, karachi or moonsighting."
    }
  },
  "required": [],
  "additionalProperties": false
}

Every question the rulebook covers. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "money",
        "crypto",
        "medicine",
        "food",
        "life"
      ],
      "description": "Only topics in this area: money, crypto, medicine, food or life."
    }
  },
  "required": [],
  "additionalProperties": false
}

How the four schools differ on food. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

The full rulebook. Answers 'is it halal?' for food, cosmetics, medicines, stocks, funds, crypto, money products and everyday life, showing where the four Sunni schools and the main scholarly bodies agree and where they differ, with the reasoning and halal alt...

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}