Hero Background

DISCOVER IRANIAN FESTIVALS | API

Reliable JSON for Iranian cultural events

Complete Coverage

All Iranian holidays, festivals, and cultural occasions

Fast & Reliable

Lightning-fast responses with 99.9% uptime

Easy Integration

Simple REST API with comprehensive docs

Bilingual Support

Supports Persian and English

Simple Integration

Get started in minutes with our REST API

Request

cURL
curl -X GET \
  'https://api.kooroshi.com/v1/occasions/today' \
  -H 'X-API-Key: your_api_key' \
  -H 'Accept-Language: fa'

Available Endpoints

/v1/occasions/today

Get today's occasions

/v1/occasions/date/:date

Get occasions for specific date

/v1/occasions/range

Get occasions in date range

Response

JSON
      {
        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:
            "همواره در روز ۱ فروردین در گاهشماری رسمی خورشیدی آغاز می‌شود.",
        },
      }

Response Features

  • Persian and Gregorian dates
  • Zoroastrian calendar events
  • Rich metadata and tags

Built for Developers

Perfect for a wide range of applications

Calendar Apps

Integrate Iranian holidays into calendar applications and scheduling tools

Cultural Projects

Build educational platforms and cultural awareness applications

Business Tools

Enhance business applications with Iranian holiday awareness

Ready to Get Started?

Start integrating Iranian festival data into your applications today