education

Get Methodology

Retrieve detailed information about a specific Shariah screening methodology.

Returns comprehensive details for the requested methodology, including its screening process, financial ratio thresholds, Shariah board information, and scholarly references. Use the methodology name or ID as returned by the /methodologies endpoint (e.g. aaoifi, sec, djim).

curl example:

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

Python requests example:

import requests

resp = requests.get("http://localhost:8000/api/education/methodologies/aaoifi")
data = resp.json()
print(f"{data['full_name']} (est. {data['established']})")
print("Thresholds:", data["thresholds"])
get/api/education/methodologies/{name}

Request

  • Base URL: https://api.halalterminal.com
  • URL: https://api.halalterminal.com/api/education/methodologies/{name}
  • Auth: API key in header X-API-Key

Path parameters

namestring required

Methodology name or ID (e.g. aaoifi, sec, djim).

Response

Detailed information for the requested methodology

idstring required

Short identifier for the methodology, e.g. 'aaoifi'

namestring required

Common name or abbreviation, e.g. 'AAOIFI'

full_namestring nullable

Full official name of the organization

establishedinteger nullable

Year the organization was established

headquartersstring nullable

City and country of the organization's headquarters

basisstring nullable

Foundation or basis of the screening methodology

overviewstring nullable

General overview of the methodology and its adoption

screening_processstring[]

Ordered steps in the screening process

thresholdsobject

Financial ratio thresholds used in compliance screening

distinguishing_featuresstring[]

Key features that distinguish this methodology from others

verdict_scopestring nullable

What the compliance verdict asserts. Halal Terminal applies the methodology's Shariah ratio thresholds to the latest reported financials. Index providers add construction rules — entry buffers, multi-period averaging, delayed removal — that manage fund turnover rather than express a Shariah criterion. Read this before comparing a verdict to actual index membership.

shariah_boardstring nullable

Name of the Shariah supervisory board

referencesstring[]

Published standards or scholarly references

Example response

{
  "basis": "Shariah standards developed by an independent board of scholars",
  "distinguishing_features": [
    "Uses total assets as denominator for financial ratios",
    "Stricter thresholds compared to market-cap-based methodologies"
  ],
  "established": 1991,
  "full_name": "Accounting and Auditing Organization for Islamic Financial Institutions",
  "headquarters": "Manama, Bahrain",
  "id": "aaoifi",
  "name": "AAOIFI",
  "overview": "AAOIFI sets accounting, auditing, governance, and Shariah standards adopted by Islamic financial institutions in over 45 countries.",
  "references": [
    "AAOIFI Shariah Standard No. 21"
  ],
  "screening_process": [
    "Business activity screening for haram revenue",
    "Financial ratio screening using total assets as denominator"
  ],
  "shariah_board": "AAOIFI Shariah Board",
  "thresholds": {
    "max_debt_to_total_assets": 0.3,
    "max_haram_revenue_percentage": 0.05,
    "max_interest_income_to_revenue": 0.05
  }
}

Changes

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