New Numerology API

Yogas and doshas

Kaal sarp dosh in Vedic astrology

Kaal sarp dosh (kaal sarpa dosha) is said to form when all seven planets from the Sun to Saturn sit on one side of the Rahu and Ketu axis. So all of them sit between Rahu and Ketu, two points on the Moon's path. It is a later tradition, not found in the oldest texts. Schools of astrology differ on its details.

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

Kaal sarp dosh: how the API computes it

The API draws a line from Rahu to Ketu. These are the two points where the Moon's path crosses the Sun's path, and they are always exactly opposite each other. That line splits the zodiac into two halves.

If all seven planets from the Sun to Saturn fall in one half, the dosha is present (DO-03). Rahu and Ketu themselves are not counted. A planet may sit within 1 degree of the line. Then the response marks the result as partial, because schools disagree on whether that breaks the dosha.

The API reports this and does not decide it for you. Call POST /v1/dosha/kaalsarpa. The response lists the planets on each side of the line and says whether the dosha is present. It also gives a plain-English answer you can show to users.

Remedies for this dosha appear in the reading sections only when the chart has it (RM-04).

Kaal sarp dosh in a real API answer

POST /v1/dosha/kaalsarpa200 OK
{
  "present": false,
  "grahas_between_rahu_and_ketu": [
    "Moon",
    "Mars",
    "Jupiter",
    "Venus"
  ],
  "grahas_between_ketu_and_rahu": [
    "Sun",
    "Mercury",
    "Saturn"
  ],
  "answer": {
    "headline": "No Kaal Sarp dosha. Your planets sit on both sides of the Rahu-Ketu line, so they are not hemmed in."
  }
}
Whether John Doe's chart has kaal sarp dosh: the planets on each side of the Rahu-Ketu line, and the answer in plain English. Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.

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/kaalsarpa

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/dosha/kaalsarpa" \
  -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/remedies/charityCharity (daan) this chart points to, and why
POST/v1/remedies/fastingFasting (vrat) this chart points to, and why
POST/v1/reading/section/{section_id}One section of a reading

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 countkaalsarpa: all seven planets from the Sun to Saturn on one side of the Rahu-Ketu axis.
  • 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.

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

From the blog

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