
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: {
slug: "norooz",
name: "نوروز",
aliases: ["سال نو", "نوروز کوچک", "اعتدال بهاری"],
day: 1,
isFloating: false,
calendar_system: "گاهشماری هجری خورشیدی",
origin_type: "ایرانی پیشازرتشتی",
ritual_summary:
"جشن آغاز سال نو، رستاخیز طبیعت، رویش و پیوند انسان با جهان هستی",
deity_or_concept: {
name: "نظم کیهانی (اشه)",
meaning: "آغاز دوباره، دادگری طبیعت و هماهنگی هستی",
},
festival_meaning: {
pre_zoroaster: "آغاز سال کشاورزی و جشن نو شدن چرخه فصلها",
post_zoroaster:
"نو شدن جهان در چارچوب راستی و شکست نمادین سرمای اهریمنی",
},
regional_variations: [
"در سراسر حوزه تمدنی ایرانزمین، قفقاز، آسیای میانه و کردستان با رسوم چیدن هفتسین و دیدوبازدید برگزار میشود",
],
audience_note:
"کهنترین جشن زنده مشترک مردمان فلات ایران با ثبت میراث جهانی یونسکو",
historical_confidence: "بالا",
importance: "بالا",
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