POST/api/astro/lunar_month_scan/1 Credit

Mondmonats-Scan

Findet die exakten Anfangs- und Endzeitpunkte eines bestimmten hinduistischen Mondmonats in einem Kalenderjahr – Chaitra, Vaisakha, Jyeshtha und so weiter. Praktisch für alles, was sich nach einem Mondmonat statt nach einem gregorianischen Monat richtet. reckoning bestimmt, wo die Grenzen liegen. Bei 'amanta' (Standard, im Süden und Westen üblich) reicht ein Monat von einem Neumond zum nächsten und ist nach dem Zeichen des Mondes beim Neumond zu Monatsbeginn benannt. Bei 'poornima' reicht er von einem Vollmond zum nächsten und ist nach dem Zeichen der Sonne beim Vollmond zu Monatsbeginn benannt. Diese Zählung nutzen die nördlichen Kalender; in der dunklen Monatshälfte ordnen die beiden Zählungen denselben Tag unterschiedlich benannten Monaten zu. Übergib month_name, year und timezone_as_float; ein Ort ist nicht nötig. Die Antwort ist {year, month_name, reckoning, rows}; rows ist eine Liste von {start, end}-Zeitstempeln in UTC – meist mit einem Eintrag, mit zweien, wenn in dasselbe Jahr auch ein gleichnamiger Adhika-Monat (Schaltmonat) fällt. Der Scan kennzeichnet nicht, welcher der beiden der Schaltmonat ist.

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

Anfrage testen

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
month_name	string	Pflicht	`VaisakhaJyeshthaAshadhaShravanaBhadrapadaAshwinKartikaMargashirshaPaushaMaghaPhalgunaChaitra`
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
reckoning	string	optional	`amantapoornima`

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/lunar_month_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month_name":"Vaisakha","timezone_as_float":5.5,"year":2026,"reckoning":"amanta"}'

Antwort

{
  "data": {
    "year": 2026,
    "month_name": "Vaisakha",
    "reckoning": "amanta",
    "rows": [
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-05-16T20:01:32+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

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.