education

Get Glossary

Retrieve the Islamic finance glossary, optionally filtered by search query.

Returns a list of key Islamic finance terms (e.g. Riba, Gharar, Murabaha, Sukuk) with their Arabic script, definitions, categories, and scholarly references. Use the optional query parameter to search for specific terms.

curl example:

curl -X GET "http://localhost:8000/api/education/glossary?q=riba"

Python requests example:

import requests

resp = requests.get(
    "http://localhost:8000/api/education/glossary",
    params={"q": "riba"},
)
for term in resp.json()["terms"]:
    print(f"{term['term']} ({term['arabic']}): {term['definition']}")
get/api/education/glossary

Request

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

Query parameters

qstring nullable

Free-text search term to filter glossary entries.

Response

List of Islamic finance glossary terms

countinteger required

Number of glossary terms returned

querystring nullable

The search query used to filter terms, if any

Example response

{
  "count": 2,
  "query": "riba",
  "terms": [
    {
      "arabic": "ربا",
      "category": "prohibited_elements",
      "definition": "Interest or usury, prohibited in Islamic finance.",
      "references": [
        "Quran 2:275"
      ],
      "term": "Riba"
    },
    {
      "arabic": "ربا الفضل",
      "category": "prohibited_elements",
      "definition": "Excess in exchange of commodities of the same type.",
      "references": [],
      "term": "Riba al-Fadl"
    }
  ]
}

Changes

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