Matching and doshas
Dosha API and yoga checks, in plain English
Our dosha API checks a birth chart for manglik, kaal sarp and pitra dosha and gives the result in plain English, with the rule it used. It also finds the chart's yogas (planet combinations) and dates every sade sati. Exceptions are listed, not applied, so an astrologer can weigh them.
POST /v1/dosha/pitra200 OK{
"dosha": "pitra",
"present": true,
"rule": "Sun, Rahu or Ketu afflicting the 9th house or its lord, or the 9th lord placed in a dusthana",
"answer": {
"status": "present",
"headline": "Pitra dosha is present, because Ketu sits with the ruler of your 9th house."
}
}What the dosha API returns
- Manglik, kaal sarp and pitra dosha, one at a time or all three: present or not, the rule tested, and the placements that decided it.
- A plain answer for each dosha: a headline, what it means, any exception in the chart, and what to do next.
- Manglik counted three ways, from the rising sign, the Moon and Venus. Known exceptions are listed but not applied.
- The papa samyam count: the manglik check asked of all five difficult planets, as used in matching.
- Yogas found in the chart, each with its rule and the chart facts that met it, plus yogas that came close, with the reason they did not form.
- The ruler of the rising sign (lagnesh) and the yogakaraka, the planet that helps most for this rising sign.
- Sade sati: every one in the 100 years from birth, the phase running now (rising, peak or setting), and the two shorter Saturn periods (dhaiya).
The dosha answers come from fixed rules, not an AI model, so the same chart always gets the same words. The rulebook documents 64 yogas, including the 32 Nabhasa yogas, each with its own ID.
The rules behind it
Manglik is Mars in house 1, 2, 4, 7, 8 or 12, counted from the rising sign, the Moon and Venus (DO-01). Its classical exceptions are reported, not applied (DO-02). Kaal sarp means all seven planets from the Sun to Saturn sit on one side of the Rahu-Ketu axis (DO-03). Pitra dosha looks at the 9th house and its ruler (DO-04). Each yoga has its own rule, from Ruchaka (YG-01) to the Nabhasa yogas (YG-33 onward). Sade sati dates include every time Saturn crosses a sign boundary (SS-03), and the dhaiya periods are reported apart from it (SS-02).
Browse the full rulebookTerms used here
Who uses it
- Matrimony and matchmaking sitesKundli matching for every profile pair: the 36-point score, manglik checks and a clear verdict, even for members with no birth time.
- Astrology appsCharts, dashas, daily readings and a printable report from one API, so a small team can ship a full astrology app.
- Puja and spiritual storesGemstone, rudraksha and puja suggestions tied to each customer's chart, with the reason for every one.
- AI assistants and chatbotsReal charts and plain answers for AI assistants and chatbots, so the model quotes a computed result instead of inventing one.
Astrology API
Call it with a free test key
Create an account and a test key, then call any endpoint on this page. Or try a request in the API reference first.
01
A free test key, with 1,000 requests a month
02
Try any endpoint in your browser first
03
Every rule published, so you can check any answer