---
title: "Get Methodologies"
method: GET
path: "/api/education/methodologies"
tags: ["education"]
---

# Get Methodologies

`GET /api/education/methodologies`

## Request

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

List all supported Shariah screening methodologies.

Returns summary information for every screening methodology available in
the system, such as AAOIFI, SEC Malaysia, DJIM, MSCI, and FTSE. Each
entry includes identification, thresholds, and distinguishing features.

**curl example:**
```bash
curl -X GET "http://localhost:8000/api/education/methodologies"
```

**Python requests example:**
```python
import requests

resp = requests.get("http://localhost:8000/api/education/methodologies")
for m in resp.json()["methodologies"]:
    print(f"{m['name']}: {m.get('full_name', 'N/A')}")
```

## Response `200`

List of all available Shariah screening methodologies

- MethodologiesResponse: List of all available Shariah screening methodologies.
  - `count` integer, required: Number of methodologies available
  - `methodologies` MethodologyDetailResponse[], required: List of screening methodology details
    - `id` string, required: Short identifier for the methodology, e.g. 'aaoifi'
    - `name` string, required: Common name or abbreviation, e.g. 'AAOIFI'
    - `full_name` string, nullable: Full official name of the organization
    - `established` integer, nullable: Year the organization was established
    - `headquarters` string, nullable: City and country of the organization's headquarters
    - `basis` string, nullable: Foundation or basis of the screening methodology
    - `overview` string, nullable: General overview of the methodology and its adoption
    - `screening_process` string[]: Ordered steps in the screening process
    - `thresholds` object: Financial ratio thresholds used in compliance screening
    - `distinguishing_features` string[]: Key features that distinguish this methodology from others
    - `verdict_scope` string, 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_board` string, nullable: Name of the Shariah supervisory board
    - `references` string[]: Published standards or scholarly references

## Other responses

- `401`: Authentication required
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/halalterminal/apis/halal-terminal-api.md) · [All operations](https://skmtc.dev/halalterminal/apis/halal-terminal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/halalterminal/apis/halal-terminal-api/revisions/78768b250943?raw)
