Appearance

Atmakaraka ​

http
POST /v1/atmakaraka

Returns the Atmakaraka — the planet with the highest degrees in the chart, considered the soul-significator. Also returns the Atma karaka's sign, house, and its aspects.

Request body: { "profileId": "..." }

Response

json
{
  "success": true,
  "data": {
    "planet": "Jupiter",
    "sign": "Scorpio",
    "degree": 23.41,
    "house": 8,
    "nakshatra": "Anuradha",
    "aspects": [
      { "aspectPlanet": "Mars", "aspectDegree": 45, "nature": "benefic" }
    ],
    "description": "Jupiter as Atmakaraka in the 8th house indicates spiritual inclination, wisdom through transformation, and interest in occult sciences."
  }
}

Vargas (Divisional Charts) ​

http
POST /v1/vargas

Returns planet positions in divisional charts from D1 (Rashi) through D60. The most commonly used are:

  • D1 (Rashi) — main chart
  • D2 (Hora) — wealth
  • D3 (Drekkana) — siblings
  • D4 (Chaturthamsha) — fortune
  • D7 (Saptamsha) — progeny
  • D9 (Navamsha) — marriage/spouse (most important)
  • D10 (Dasamsha) — career
  • D12 (Dwadashamsha) — parents

Request body: { "profileId": "..." }

Response

json
{
  "success": true,
  "data": {
    "divisions": {
      "D1": { "planets": [...] },
      "D9": { "planets": [...] },
      "D10": { "planets": [...] }
    }
  }
}

Functional Nature ​

http
POST /v1/functional

Returns the functional nature (benefic/malefic/neutral) of each planet based on the lagna (ascendant). This determines which planets give results and which are weaker in the chart.

Request body: { "profileId": "..." }

Response

json
{
  "success": true,
  "data": {
    "planets": [
      { "planet": "Sun", "nature": "malefic", "reason": "6th lord in 8th house" },
      { "planet": "Moon", "nature": "benefic", "reason": "9th lord in moksha sthana" },
      { "planet": "Mars", "nature": "neutral", "reason": "yogakaraka but in 12th" }
    ],
    "functionalSummary": {
      "mostBenefic": "Moon",
      "mostMalefic": "Saturn",
      "yogakaraka": "Mars"
    }
  }
}