اوقاتِ نماز

زمین پر کسی بھی مقام کے لیے جعفری (شیعہ) حسابات — تیار طریقے، بیک وقت کئی، یا مکمل اپنی مرضی کے زاویے؛ فی درخواست ایک دن، مہینہ یا پورا سال۔ بلند عرض البلد TwilightAngle قاعدے سے سنبھالے جاتے ہیں اور شرعی نصف شب غروب تا صبحِ صادق کا وسط ہے۔

GET https://theshia.org/api/v1/prayer-times

پیرامیٹرز

lat required* latitude, -90 to 90 (decimal degrees, rounded to 2 dp for caching). *Not needed when city is given.
lng required* longitude, -180 to 180 (2 dp). *Not needed when city is given.
city optional city id from /cities (e.g. london, tehran, karbala) — sets lat, lng and tz automatically and overrides them.
method default: Tehran preset id (full value table under Calculation methods) · comma list "Tehran,Jafari" · "all" (all 16) · "custom" (with the angle parameters below).
fajrAngle custom only Fajr sun-depression angle, 4 to 24 degrees. Required when method=custom.
ishaAngle custom only Isha angle, 4 to 24 degrees. Give this OR ishaInterval.
ishaInterval custom only Isha as minutes after maghrib, 0 to 180. Alternative to ishaAngle.
maghribAngle custom only Maghrib sun-depression angle, 0.5 to 12 degrees (Shia methods typically 4–4.5).
maghribInterval custom only Maghrib as minutes after sunset, 0 to 120. Alternative to maghribAngle.
date optional a single day, YYYY-MM-DD.
month default: current 1 to 12, combined with year. Ignored when date is given.
year default: current 1900 to 2100. Given ALONE (no month/date) = the full year, single method only.
tz optional IANA timezone (e.g. Europe/London) — adds local HH:mm strings next to the UTC instants. Auto-filled from city.

Budget: days × methods per request must be ≤ 496 (a month allows all 16 methods; a year allows one).
Response: meta { lat, lng, city?, tz, qibla, method? } and per day: date + imsak, fajr, sunrise, dhuhr, asr, sunset, maghrib, isha, midnight as ISO 8601 UTC instants (+ local { … } when tz is set). Multiple methods return results: [ { method, days } ].
Always applied: TwilightAngle high-latitude rule; imsak = fajr − 10 min; midnight = midpoint of maghrib and the next day's fajr.

زندہ مثال کھولیں ↗

کوڈ کے نمونے

curl

curl "https://theshia.org/api/v1/prayer-times?city=london&method=Tehran&year=2026&month=7"

JavaScript

const res = await fetch("https://theshia.org/api/v1/prayer-times?city=london&method=Tehran&year=2026&month=7");
const data = await res.json();

Python

import requests

data = requests.get("https://theshia.org/api/v1/prayer-times?city=london&method=Tehran&year=2026&month=7").json()

حدود اور منصفانہ استعمال

جوابات ایج پر سختی سے کیش ہوتے ہیں — براہِ کرم اپنی طرف بھی کیش کریں۔ غیر کیش درخواستیں فی IP 100 فی منٹ تک محدود ہیں؛ 496 دن×طریقہ سے بڑی درخواستیں مسترد ہوتی ہیں۔ کمیونٹی کے لیے مفت، دستیابی کی ضمانت نہیں۔