New Numerology API

Yogas and doshas

Dosha in Vedic astrology

A dosha is a chart feature that tradition treats as a problem, mostly in marriage matching. The API checks manglik dosha, kaal sarp dosh and pitra dosh. Each result says whether the dosha is present, the rule used and the placements that decided it. Known cancellations are listed, not applied.

Updated

More terms in Yogas and doshas

© API for Astrology (apiforastrology.com). "Glossary houses chart". All rights reserved. Not to be copied or reused.123456789101112A North Indian chart has 12 houses

Dosha: how the API computes it

POST /v1/dosha/{name} checks one dosha or all of them. The names are manglik, kaalsarpa and pitra. There is also a papa count, a count of malefic (harmful) planets in certain houses.

Each result says whether the dosha is present, which rule decided it, and which placements caused it. Manglik counts Mars in house 1, 2, 4, 7, 8 or 12 from the ascendant, the Moon and Venus (DO-01). Kaal sarp checks if all seven planets sit on one side of the line from Rahu to Ketu (DO-03).

Rahu and Ketu are the two points where the Moon's path crosses the Sun's path. Pitra looks at the Sun, Rahu and Ketu around the 9th house (DO-04). The API also finds four classical cancellations for manglik and lists them. But it never applies them, because astrologers disagree about which ones count (DO-02). So present does not always mean a problem.

A good page shows the finding and the listed cancellations together. It leaves the conclusion to the reader. The dosha chapters in the report and the remedies appear only when the chart has the dosha.

Get it from the API

Doshas: manglik, kaal sarpa, pitra, or the papa count. Here is the call to API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990, 10:30 AM, New York.

POST /v1/dosha/all

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dosha/all" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

Where the API returns it

POST/v1/dosha/{name}Doshas: manglik, kaal sarpa, pitra, or the papa count
POST/v1/matchingMarriage compatibility score (ashtakoot, 36 points)
POST/v1/matching/nakshatraCompatibility score from two nakshatras, no birth charts
POST/v1/summaryPlain-language summary of a chart
POST/v1/reading/section/{section_id}One section of a reading
POST/v1/remedies/charityCharity (daan) this chart points to, and why

What the API reference says

Each line is quoted from the reference page of the endpoint named above it.

  • POST /v1/dosha/{name} · Doshas: manglik, kaal sarpa, pitra, or the papa countChecks the chart for one dosha, or for all three.
  • POST /v1/matching · Marriage compatibility score (ashtakoot, 36 points)The texts that describe these problems (doshas) also give exceptions that cancel them.
  • POST /v1/remedies/charity · Charity (daan) this chart points to, and whymanglik (Mars), kaalsarpa (Rahu and Ketu) and pitra (the Sun, with tithi: Amavasya, the new-moon day): only when /v1/dosha/all reports that dosha present.
  • POST /v1/reportPass topics=true to add the 32 topic readings (the sade sati and dosha remedy topics appear only when the chart has them).

Feature page: Yogas and doshas. Who uses it: Astrologer consultation platforms. The classical rules the API follows are in the rulebook.

How we check the numbers

Every value here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test.

Related terms

Astrology API

Get these values from the API

Create a free test key and call any endpoint on this page. Or try a request in the API reference first.

Get a free API keyOpen the API reference

Your first answer

John Doe, New York

POST /v1/planets200 OK
  • RisingVirgoHast
  • SunCancerAshlesha
  • MoonTaurusMrigashira
  • MarsAriesKrittika

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    Open rules: every rule is published, so you can check any answer