
Reliable JSON for Iranian cultural events
All Iranian holidays, festivals, and cultural occasions
Lightning-fast responses with 99.9% uptime
Simple REST API with comprehensive docs
Supports Persian and English
Get started in minutes with our REST API
curl -X GET \ 'https://api.kooroshi.com/v1/occasions/today' \ -H 'X-API-Key: your_api_key' \ -H 'Accept-Language: fa'
/v1/occasions/todayGet today's occasions
/v1/occasions/date/:dateGet occasions for specific date
/v1/occasions/rangeGet occasions in date range
{
logo_url: "https://res.cloudinary.com/daqtj4jyl/image/upload/v1771349856/IranianFestivalsApi/norooz_pckvdn.png",
month: {
name: "فروردین",
number: 1,
meaning: "پیشبرنده، نیروی زندگی",
root: "فروهر",
},
festival: {
name: "نوروز",
day: 1,
origin_type: "ایرانی پیشازرتشتی",
ritual_summary: "جشن آغاز سال نو، زایش طبیعت و نو شدن جهان",
deity_or_concept: {
name: "نظم کیهانی",
meaning: "آغاز دوباره، هماهنگی جهان و زندگی",
},
festival_meaning: {
pre_zoroaster: "آغاز بهار و چرخه طبیعی زندگی",
post_zoroaster: "نو شدن جهان در چارچوب راستی و نظم",
},
audience_note: "جشنی کاملا طبیعی که بعدها معنا و تفسیر دینی گرفت",
historical_confidence: "بالا",
tags: ["سال نو", "بهار", "طبیعت"],
date_type: "ثابت",
date_type_explanation: "نوروز همیشه در روز ۱ فروردین برگزار میشود و تاریخ آن در تقویم رسمی شمسی تغییر نمیکند، هرچند لحظه تحویل سال نجومی است و زمان آن هر سال متغیر است.",
},
}Perfect for a wide range of applications
Integrate Iranian holidays into calendar applications and scheduling tools
Build educational platforms and cultural awareness applications
Enhance business applications with Iranian holiday awareness
Start integrating Iranian festival data into your applications today