Direkt zum Inhalt
POST/api/astro/dosha/1 Credit

Doshas

Ein Dosha ist eine bestimmte Belastung im Geburtshoroskop – eine benannte Planetenkonfiguration, die klassische Texte als nachteilig ansehen, meist für Ehe, Gesundheit oder die Ahnenlinie. Dieser Endpoint prüft acht davon anhand von Geburtszeitpunkt und -ort und liefert entweder die reinen Ergebnisse oder fertige Erklärungstexte zur Anzeige. Du kannst ihn auf zwei Arten nutzen. Die einzelnen Keys (`kala_sarpa`, `manglik`, `pitru_dosha` und die übrigen) liefern strukturierte Ergebnisse, die du im Code auswerten kannst. `get_dosha_details` liefert alles als formatierte HTML-Absätze mit dem englischen Dosha-Namen als Schlüssel – das Richtige, wenn du einen Bericht renderst. Enthalten sind Kala Sarpa, Manglik, Pitru, Guru Chandala, Kalathra, Ghata und Shrapit, nicht aber Ganda Moola. `get_dosha_resources` liefert dir den zugrunde liegenden Textkorpus, falls du eigene Texte zusammenstellen willst. Der Serializer verlangt alle booleschen und strukturierten Anfragefelder, auch für Keys, die sie ignorieren. `manglik_reference_planet` ist ein Planetenindex (0 Sonne, 1 Mond, 2 Mars, 3 Merkur, 4 Jupiter, 5 Venus, 6 Saturn, 7 Rahu, 8 Ketu); der eigentliche Standard des Rechenkerns – die Messung ab dem Aszendenten – lässt sich über die API nicht wählen, weil das Feld als Ganzzahl typisiert ist. Bei diesem Endpoint heißt das Feld für den UTC-Offset `timezone`, nicht `timezone_as_float`.

https://api.occultapi.com/api/astro/dosha/
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

FeldTypPflichtHinweise
apply_exceptionsbooleanPflicht
date_timestring (date-time)Pflicht

Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten.

FORMATVORGABE. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen).

include_2nd_housebooleanPflicht
include_lagna_housebooleanPflicht
keysarrayPflicht

Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen.

get_dosha_resourceskala_sarpamanglikpitru_doshaguru_chandala_doshakalathraganda_moolaghatashrapitget_dosha_details

Array von Strings. 'manglik' erfordert manglik_reference_planet, include_lagna_house, include_2nd_house und apply_exceptions; 'ganda_moola' erfordert moon_star; 'get_dosha_details' erfordert date_time und geopos.

latitudenumber (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.

min -90 · max 90

longitudenumber (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.

min -180 · max 180

manglik_reference_planetintegerPflicht
moon_starstringPflicht

Inhaltlich eine Nakshatra-NUMMER 1-27 (die Ganda-Moola-Nakshatras sind 1 Ashwini, 9 Ashlesha, 10 Magha, 18 Jyeshtha, 19 Moola, 27 Revati). Eine funktionierende Liste zulässiger Werte lässt sich erst angeben, wenn dieser Typkonflikt behoben ist.

timezonenumber (double)Pflicht

UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30). Bedeutet dasselbe wie timezone_as_float; andere Endpoints verwenden für dasselbe Feld nur einen anderen Namen.

Verfügbare Keys (10)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

KeyZusätzliche FelderBeschreibung
ganda_moolamoon_starGanda Moola: ob das Geburts-Nakshatra eines der sechs Übergangs-Nakshatras ist (Ashwini, Ashlesha, Magha, Jyeshtha, Moola, Revati). Eigentlich soll der Key die Nakshatra-Nummer 1–27 in `moon_star` entgegennehmen und einen booleschen Wert liefern. Das Feld ist aber als String typisiert, während die Vergleichsliste Ganzzahlen enthält – derzeit liefert der Key deshalb für jede Eingabe false.
get_dosha_detailsdate_time, geoposAlle sieben beschreibenden Doshas auf einmal ausgewertet und als Text ausformuliert: ein Objekt mit dem englischen Dosha-Namen als Schlüssel – Kala Sarpa Dosha, Manglik Dosha, Pitru Dosha, Guru Chandala Dosha, Kalathra Dosha, Ghata Dosha und Shrapit Dosha. Die Werte sind HTML-Fragmente, die angeben, ob das Dosha vorliegt und was es bedeutet. Ganda Moola ist nicht enthalten. Erfordert `date_time` und den Ort.
get_dosha_resources—Alle Erklärungstexte zu den Doshas, als Objekt mit dem Dosha-Namen als Schlüssel ('kala_sarpa', 'manglik', 'pitru', 'ghata' usw.) und jeweils einer Liste englischer Absätze. Der erste Eintrag einer Liste ist der Text für „Dosha liegt nicht vor“, die weiteren Einträge gehören zum jeweiligen Haus bzw. zur jeweiligen Variante. Damit kannst du eigene Texte rendern, statt das fertig zusammengesetzte HTML zu verwenden.
ghata—Ghata Dosha: Mars und Saturn zusammen im selben Zeichen. Liefert einen einzelnen booleschen Wert.
guru_chandala_dosha—Guru Chandala: Jupiter in Konjunktion mit Rahu oder Ketu im selben Zeichen. Liefert eine Liste mit zwei Elementen: [ob die Kombination vorliegt, ob Jupiter der stärkere der beiden ist]. Ohne Konjunktion sind beide false.
kala_sarpa—Kala Sarpa Dosha: true, wenn alle sieben klassischen Planeten auf einer Seite der Knotenachse zwischen Rahu und Ketu eingeschlossen sind. Liefert einen einzelnen booleschen Wert; die Variante (Ananta, Kulika, Vasuki usw.) ergibt sich aus dem Haus, in dem Rahu steht.
kalathra—Kalathra Dosha, die Belastung des Ehehauses. Ergibt true, wenn jeder natürliche Übeltäter – Sonne, Mars, Saturn, Rahu und Ketu – im 1., 2., 4., 7., 8. oder 12. Haus steht, gezählt ab dem 7. Haus. Liefert einen einzelnen booleschen Wert; weil alle fünf Übeltäter die Bedingung erfüllen müssen, ist er selten true.
manglikmanglik_reference_planet, include_lagna_house, include_2nd_house, apply_exceptionsManglik oder Mangal Dosha: ob Mars in einem der Häuser steht, die die Ehe belasten, gezählt ab `manglik_reference_planet`. Liefert eine Liste mit drei Elementen: [ist Manglik, ob eine Aufhebung greift, die Nummern der zutreffenden Aufhebungsregeln]. Geprüft werden das 4., 7., 8. und 12. Haus, außerdem das 2. Haus, wenn `include_2nd_house` true ist, und das 1. Haus, wenn `include_lagna_house` true ist. Aufhebungen werden nur ausgewertet, wenn `apply_exceptions` true ist.
pitru_dosha—Pitru Dosha, die Belastung der Ahnenlinie. Liefert eine Liste mit zwei Elementen: [true oder false, die Nummern der ausgelösten Regeln]. Fünf Regeln werden der Reihe nach geprüft: ein Licht oder Rahu im 9. Haus, Ketu im 4. Haus, Sonne/Mond/Rahu/Ketu durch Mars oder Saturn verletzt, eine Häufung von Merkur, Venus und Rahu im 2., 5., 9. oder 12. Haus sowie Sonne oder Mond in Konjunktion mit einem Mondknoten.
shrapit—Shrapit Dosha: Saturn und Rahu zusammen im selben Zeichen. Liefert einen einzelnen booleschen Wert.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/dosha/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_dosha_resources"],"date_time":"2025-07-11T04:37:08.718Z","latitude":26.9124,"longitude":75.7873,"timezone":0,"manglik_reference_planet":0,"include_lagna_house":true,"include_2nd_house":true,"apply_exceptions":true,"moon_star":"leo"}'

Antwort

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"get_dosha_resources\": {\"kala_sarpa\": [\"There is no Kala Sarpa Dosha in this horoscope.\", \"Ananta Kala Sarpa Dosha- Rahu in 1st House and Ketu in 7th House. In this Dosha, Rahu is placed in the 1st house and Ketu in the 7th house in the horoscope. All planets are placed between Rahu-Ketu from the 1st house to the 7th house. This alignment can make a person ill-tempered and bring health issues. There would be problems in marital relationships, and, if in business, there would be a lack of support from partners.\", \"Kulik Kala Sarpa Dosha- Rahu in 2nd House and Ketu in 8th House. This Dosha is formed when Rahu is in the 2nd house and Ketu is in the 8th house, and all planets are between them. The individual afflicted may be vile-tongued and lead a life without the support of relatives. Monetary problems might surface, and savings might not be possible. The afflicted native may undergo surgery or accidents. There may be a possibility of unnatural death.\", \"Vasuki Kala Sarpa Dosha- Rahu in 3rd House and Ketu in 9th House. This Dosha is formed in the horoscope when Rahu and Ketu are in the 3rd, and 9th houses, respectively, and the remaining planets are hemmed between them. The afflicted individual may be timid in disposition and unable to fight for self-esteem. Relationships with younger siblings might not be good. Tide will go against the individual who may be unable to overcome adversity. The native can lack interest in religion, and luck may not favor them.\", \"Shankapal Kala Sarpa Dosha- Rahu in 4th House and Ketu in 10th House. This Dosha is formed when all planets are between Rahu and Ketu, which are placed from the 4th house to the 10th house. This alignment causes the native to have a bad relationship with the mother. The individual might not have mental peace and face professional problems.\", \"Padma Kala Sarpa Dosha- Rahu in 5th House and Ketu in 11th House. The axis of Rahu-Ketu from the 5th house to the 11th house and all planets within this axis cause this Dosha. The afflicted individual can face an issue with childbirth and education. They may have problems earning and may get into conflict with elder siblings.\", \"Mahapadma Kala Sarpa Dosha- Rahu in 6th House and Ketu in 12th House. The alignment of all planets in the Rahu-Ketu axis of the 6th house to the 12th house causes this Dosha. The afflicted individual can be dominated by enemies and lose money and property. The native could waste money, be unpopular, and have conflicts with in-laws.\", \"Takshak Kala Sarpa Dosha- Rahu in 7th House and Ketu in 1st House. The placement of all planets in the axis of Rahu-Ketu from the 7th house to the 1st house cause this Dosha. The afflicted may not go through marriage. If married, then the marriage might not go well. This Dosha can create a rift between the couple, leading to separation.\", \"Karakotak Kala Sarpa Dosha- Rahu in 8th House and Ketu in 2nd House. The placement of Rahu in the 8th house and Ketu in the 2nd house and the remaining planets in between them can cause this Dosha. The afflicted native might be ill-tempered and befriend anti-social elements. The native might have enemies and not be granted paternal wealth.\", \"Shankachood Kala Sarpa Dosha- Rahu in 9th House and Ketu in 3rd House. When Rahu is placed in the 9th house, Ketu in the 3rd house and all planets are between Rahu and Ketu; this Dosha is created in the horoscope. An afflicted individual might struggle a lot in life, and luck may never favor them. The individual may develop a habit of lying constantly and could be short-tempered.\", \"Ghatak Kala Sarpa Dosha- Rahu in 10th House and Ketu in 4th House. This Dosha is formed when Rahu is placed in the 10th house, Ketu in the 4th house, and all the planets are between the 10th to 4th houses. The afflicted individual may face many hurdles in his profession and conflicts with superiors at work. The individual may lack focus and face criticism. Relationships with family members may be poor. There may be de"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

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.