POST/api/astro/horoscope-match/1 Credit

Horoskopabgleich für die Ehe

Vollständiger Ashtakoota-Abgleich für die Ehe auf Basis zweier Geburtsdaten statt zweier Nakshatra-Nummern. Gib Datum, Uhrzeit und Ort beider Partner an: Der Endpoint ermittelt Mondzeichen, Nakshatra und Pada selbst, bewertet die acht Kootas mit bis zu 36 Punkten, prüft die beiden ausschließenden Doshas und liefert ein Urteil. Die Antwort besteht aus vier Teilen. `boy` und `girl` fassen jedes Horoskop zusammen: Mondzeichen, Name und Nummer des Nakshatra, Pada, Mondlänge und Aszendentenzeichen. `gunas` ist eine Liste von acht Objekten, eines pro Koota, jeweils mit `key` und `label`, `max_points` und `obtained_points`, den verglichenen Werten `boy_value` und `girl_value` (Varna, Yoni-Tier, Gana usw.), dem zugehörigen Lebensbereich `area_of_life` und einer `description` in einfachem Englisch – genug für eine Ergebnistabelle, ohne dass du selbst Texte schreiben musst. Danach folgen `total_score`, `max_score` mit 36 und `minimum_recommended_score` mit 18. Zum Schluss `doshas`, `verdict` und `verdict_reason`. Eine Nadi-Punktzahl von null löst das Nadi-Dosha aus, eine Bhakoot-Punktzahl von null das Bhakoot-Dosha; jedes der beiden macht das Urteil unabhängig von der Summe zu 'Union is NOT Recommended'. Ansonsten gilt: 28 oder mehr ist 'Union is Excellent', 18 oder mehr 'Union is Good', darunter wird die Verbindung nicht empfohlen. Jedes Partnerobjekt nimmt `date_time`, `latitude`, `longitude` und `timezone_as_float` entgegen, dazu die optionalen Labels `name` und `city`, die unverändert zurückkommen. Es gilt immer das Lahiri-Ayanamsa; das Feld `ayanamsa` wird akzeptiert, hat aber keine Wirkung.

https://api.occultapi.com/api/astro/horoscope-match/

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
boy	object	Pflicht	OBJEKT mit festen Schlüsseln: name (String, optional, Freitext-Label), date_time (erforderlich, ISO-8601), latitude (erforderlich, -89.9..89.9), longitude (erforderlich, -180..180), timezone_as_float (erforderlich, -12.0..14.0), city (String, optional, Freitext-Label). `name` und `city` werden nicht validiert und beeinflussen die Berechnung nicht.
girl	object	Pflicht	OBJEKT – gleiche Struktur und Regeln wie `boy`.
ayanamsa	string	optional

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/horoscope-match/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boy":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5},"girl":{"date_time":"2026-09-01T06:00:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}}'

Antwort

{
  "data": {
    "boy": {
      "name": "",
      "city": "",
      "moon_sign": "Aries",
      "nakshatra": "Ashwini",
      "nakshatra_number": 1,
      "paadha_number": 1,
      "moon_longitude": 1.478,
      "ascendant_sign": "Leo"
    },
    "girl": {
      "name": "",
      "city": "",
      "moon_sign": "Aries",
      "nakshatra": "Ashwini",
      "nakshatra_number": 1,
      "paadha_number": 1,
      "moon_longitude": 1.478,
      "ascendant_sign": "Leo"
    },
    "gunas": [
      {
        "key": "varna",
        "label": "Varna",
        "max_points": 1,
        "obtained_points": 1,
        "boy_value": "Brahmin",
        "girl_value": "Brahmin",
        "area_of_life": "Obedience",
        "description": "Varna Kuta is assigned 1 point. It represents mutual love, comfort and obedience - the spiritual compatibility between the couple."
      },
      {
        "key": "vashya",
        "label": "Vashya",
        "max_points": 2,
        "obtained_points": 2,
        "boy_value": "Chatushpada",
        "girl_value": "Chatushpada",
        "area_of_life": "Mutual Control",
        "description": "Vashya Kuta is assigned 2 points. It represents mutual control or dominance, along with friendship and amenability between the couple."
      },
      {
        "key": "tara",
        "label": "Tara",
        "max_points": 3,
        "obtained_points": 3,
        "boy_value": "Sampat",
        "girl_value": "Sampat",
        "area_of_life": "Luck",
        "description": "Tara Kuta is assigned 3 points. It represents luck, auspiciousness and the transmission of mutual well-being between the couple."
      },
      {
        "key": "yoni",
        "label": "Yoni",
        "max_points": 4,
        "obtained_points": 4,
        "boy_value": "Horse",
        "girl_value": "Horse",
        "area_of_life": "Sexual Aspects",
        "description": "Yoni Kuta is assigned 4 points. It represents sexual aspects, including compatibility of intimate temperament."
      },
      {
        "key": "maitri",
        "label": "Maitri",
        "max_points": 5,
        "obtained_points": 5,
        "boy_value": "Mars",
        "girl_value": "Mars",
        "area_of_life": "Affection",
        "description": "Maitri (Graha Maitri) Kuta is assigned 5 points. It represents psychological disposition, mental qualities and affection between the couple."
      },
      {
        "key": "gana",
        "label": "Gana",
        "max_points": 6,
        "obtained_points": 6,
        "boy_value": "Deva",
        "girl_value": "Deva",
        "area_of_life": "Nature",
        "description": "Gana Kuta is assigned 6 points. It represents nature, temperament, longevity, wealth and love."
      },
      {
        "key": "bhakoot",
        "label": "Bhakoot",
        "max_points": 7,
        "obtained_points": 7,
        "boy_value": "Mesha",
        "girl_value": "Mesha",
        "area_of_life": "Love",
        "description": "Bhakoot (Rashi) Kuta is assigned 7 points. It represents children, wealth, comfort, good luck and growth of the family."
      },
      {
        "key": "nadi",
        "label": "Nadi",
        "max_points": 8,
        "obtained_points": 0,
        "boy_value": "Aadi",
        "girl_value": "Aadi",
        "area_of_life": "Health",
        "description": "Nadi Kuta is assigned 8 points, the most important of all. It represents temperament, health, and genetic compatibility for progeny."
      }
    ],
    "total_score": 28,
    "max_score": 36,
    "minimum_recommended_score": 18,
    "doshas": [
      "Nadi Dosha"
    ],
    "verdict": "Union is NOT Recommended",
    "verdict_reason": "due to Nadi Dosha"
  },
  "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.