POST/api/astro/iskcon_calendar/1 Credit

ISKCON-Kalender

Der vaishnavitische Kalender von ISKCON: ein ganzes Jahr mit Ekadashis, den Erscheinungs- und Verschwindenstagen der Acharyas und den großen Festen, datiert nach der Gaudiya-Zählung statt nach der allgemeinen hinduistischen. Die Monate tragen die zwölf Namen Vishnus – Madhava, Govinda, Damodara und die übrigen –, die beiden Monatshälften heißen Krishna und Gaura, und die Jahre werden in der Gaurabda-Ära gezählt. Übergib ein Jahr sowie Breitengrad, Längengrad und UTC-Offset, denn die beim lokalen Sonnenaufgang gültige Tithi entscheidet, auf welchen bürgerlichen Tag ein Festtag fällt. Die Antwort ist {year, events}, jedes Ereignis hat die Form {name, date, masa, paksa, tithi_number, is_adhika, gaurabda_year}. Du erhältst also das gregorianische Datum und zugleich die vaishnavitischen Koordinaten, aus denen es sich ergibt; is_adhika markiert ein Ereignis in einem Schaltmonat. Die Berechnung von Tithi und Monat folgt der GCAL-Spezifikation, die auch ISKCONs eigene Kalendersoftware nutzt, und weicht bewusst von der Methode mit siderischen Ephemeriden hinter /api/astro/panchanga/ ab. Die Daten können deshalb um einen Tag von anderen Endpoints hier abweichen. Ein Jahr umfasst mehrere hundert Ereignisse; filtere oder paginiere sie daher clientseitig.

https://api.occultapi.com/api/astro/iskcon_calendar/

Anfrage testen

Ausgabe von ISKCON-Kalender in einer Benutzeroberfläche — So sehen die Daten dieses Endpoints in einer echten Oberfläche aus. Die API liefert die Werte, das Layout baust du selbst.

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
latitude	number (double)	Pflicht	Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen.
longitude	number (double)	Pflicht	Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China.
timezone_as_float	number (double)	Pflicht	UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset.
year	integer	Pflicht	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 1800 · max 2400

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/iskcon_calendar/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"year":2026}'

Antwort

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"events\": [{\"name\": \"Shri Krishna Pushya Abhisheka\", \"date\": \"2026-01-03\", \"masa\": \"Narayana\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Ramachandra Kaviraja - Disappearance\", \"date\": \"2026-01-07\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Gopala Bhatta Goswami - Appearance\", \"date\": \"2026-01-07\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Jayadeva Goswami - Disappearance\", \"date\": \"2026-01-08\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 6, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Lochana Dasa Thakura - Disappearance\", \"date\": \"2026-01-09\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 7, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shat Tila Ekadashi\", \"date\": \"2026-01-14\", \"masa\": \"Madhava\", \"paksa\": \"Krishna\", \"tithi_number\": 11, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Sarasvati Puja\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Pundarika Vidyanidhi - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Raghunandana Thakura - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Raghunatha Dasa Goswami - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Vishwanatha Chakravarti Thakura - Disappearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrimati Vishnupriya Devi - Appearance\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Vasanta Panchami\", \"date\": \"2026-01-23\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Advaita Acharya - Appearance\", \"date\": \"2026-01-25\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 7, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Bhishmashtami\", \"date\": \"2026-01-26\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 8, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Madhvacharya - Disappearance\", \"date\": \"2026-01-27\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 9, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Ramanujacharya - Disappearance\", \"date\": \"2026-01-28\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 10, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Bhaimi Ekadashi\", \"date\": \"2026-01-29\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 11, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Varaha Dwadashi\", \"date\": \"2026-01-30\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 12, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Nityananda Trayodashi\", \"date\": \"2026-01-31\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 13, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Krishna Madhura Utsava\", \"date\": \"2026-02-01\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Narottama Dasa Thakura - Appearance\", \"date\": \"2026-02-01\", \"masa\": \"Madhava\", \"paksa\": \"Gaura\", \"tithi_number\": 15, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shri Purushottama Dasa Thakura - Disappearance\", \"date\": \"2026-02-06\", \"masa\": \"Govinda\", \"paksa\": \"Krishna\", \"tithi_number\": 5, \"is_adhika\": false, \"gaurabda_year\": 539}, {\"name\": \"Shrila Bhaktisiddhanta Sarasvati Thakura - Appearance\", \"date\": \"2026-02-06\", \"masa\": \"Govinda\", \"paksa\": \"Krishna\", \"tithi_"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.