Calculation methods
The eight supported methods, including University of Tehran, Jafari (Leva Institute, Qum), Sheikh Kalbasi, and a 15° Fajr / sunset + 15 min convention.
GET https://theshia.org/api/v1/methods
- Response: methods [ { id, label, description, source, default } ] — the ids are what prayer-times accepts in method.
| method value | name | angles | tradition |
|---|---|---|---|
Tehran default | University of Tehran | Fajr 17.7°, Maghrib 4.5°, Isha 14° | Shia |
Jafari | Jafari (Qom) | Fajr 16°, Maghrib 4°, Isha 14° | Shia |
SheikhKalbasi | Sheikh Kalbasi | Fajr 17.5°, Maghrib 3.25°, Isha 14° (+precaution) | Other |
IslamicCentreOfEngland | Fajr 15°, Maghrib sunset + 15 min | Fajr 15°, Maghrib sunset+15 min, Isha 14° | Shia |
MoonsightingCommittee | Moonsighting Committee | Fajr 18°, Isha 18° | Other |
NorthAmerica | FCNA — USA (15°) | Fajr 15°, Isha 15° | Sunni |
NorthAmericaCanada | FCNA — Canada (13°) | Fajr 13°, Isha 13° | Sunni |
UmmAlQura | Umm al-Qura (Makkah) | Fajr 18.5°, Isha 90 min | Sunni |
Code samples
curl
curl "https://theshia.org/api/v1/methods"JavaScript
const res = await fetch("https://theshia.org/api/v1/methods");
const data = await res.json();Python
import requests
data = requests.get("https://theshia.org/api/v1/methods").json()Rate limits & fair use
Responses are cached hard at the edge — please cache on your side too. Uncached requests are limited to 100 per minute per IP; oversized requests (over 496 day×method computations) are rejected. Free for community use, no uptime guarantee.