education

Get Purification Guide

Retrieve the dividend purification and zakat guide.

Returns educational content on how to purify investment returns that may contain a haram (impermissible) component. Includes the purification formula, guidance on capital gains purification, zakat calculation for investments, and scholarly references.

curl example:

curl -X GET "http://localhost:8000/api/education/purification"

Python requests example:

import requests

resp = requests.get("http://localhost:8000/api/education/purification")
guide = resp.json()
print("Formula:", guide["purification_formula"].get("formula"))
print("Zakat rate:", guide["zakat_on_investments"].get("rate"))
get/api/education/purification

Request

  • Base URL: https://api.halalterminal.com
  • URL: https://api.halalterminal.com/api/education/purification
  • Auth: API key in header X-API-Key

Response

Guide for purifying investment income

overviewobject

General overview of the purification concept

purification_formulaobject

Formula and methodology for calculating the amount to purify

capital_gains_purificationobject

Guidance on purification of capital gains from stock sales

zakat_on_investmentsobject

Zakat calculation guidance for investment portfolios

scholarly_referencesobject[]

Scholarly sources and standards referenced in the guide

Example response

{
  "capital_gains_purification": {
    "description": "Scholars differ on whether capital gains require purification."
  },
  "overview": {
    "description": "Purification is the process of cleansing investment returns from haram income by donating a proportional amount to charity."
  },
  "purification_formula": {
    "description": "Calculate the impure portion of dividends received and donate it.",
    "formula": "(Haram Revenue / Total Revenue) x Dividend Received"
  },
  "scholarly_references": [
    {
      "source": "AAOIFI Shariah Standard No. 21",
      "topic": "Purification of unlawful income"
    }
  ],
  "zakat_on_investments": {
    "description": "2.5% annual zakat on qualifying investment holdings.",
    "rate": 0.025
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.