---
title: "Get Methodology"
method: GET
path: "/api/education/methodologies/{name}"
tags: ["education"]
---

# Get Methodology

`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`

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:**
```bash
curl -X GET "http://localhost:8000/api/education/methodologies/aaoifi"
```

**Python requests example:**
```python
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"])
```

## Path parameters

- `name` string, required: Methodology name or ID (e.g. aaoifi, sec, djim).

## Response `200`

Detailed information for the requested methodology

- MethodologyDetailResponse: Detailed information about a Shariah screening methodology.
  - `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
- `422`: Validation Error
- `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)