اسلامی مناسبتیں

اہلِ بیت علیہم السلام کا منتخب کیلنڈر — 73 مناسبتیں، شیعہ تاریخوں اور چار زبانوں کے عنوانات کے ساتھ؛ کسی بھی سال میں تبدیل یا آنے والی مناسبتیں دریافت کریں۔

GET https://theshia.org/api/v1/events

پیرامیٹرز

hm optional Hijri month 1 to 12 — list that month's events.
hy optional Hijri year 1317 to 1523 — resolve every event to its Gregorian date in that year (combinable with hm).
upcoming optional 1 to 73 — the next N occurrences from today, each with gregorian date and daysUntil.
importance optional value: "major" — only the headline events (Ashura, Arbaeen, Eids, the Masumin…).
type optional values: "occasion" · "birth" · "martyrdom" · "death" · "holy".
details optional value: "1" — include the detail paragraphs (en/ar/fa; 44 events have them).
calendar default: moonsighting values: "moonsighting" · "iran" — the reckoning used to resolve dates.

73 curated events (Shia dates), titles in en/ar/fa/ur with honorifics. Events recur on their Hijri month/day; a day-30 event resolves to null in years where its month has 29 days.
Response per event: id, hijriMonth, hijriDay, type, importance, title { en, ar, fa, ur } (+ hijriYear, gregorian, daysUntil/source in resolved modes).

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

کوڈ کے نمونے

curl

curl "https://theshia.org/api/v1/events?upcoming=5&importance=major"

JavaScript

const res = await fetch("https://theshia.org/api/v1/events?upcoming=5&importance=major");
const data = await res.json();

Python

import requests

data = requests.get("https://theshia.org/api/v1/events?upcoming=5&importance=major").json()

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

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