Transits

POST /v1/transits

Returns current planet positions relative to the natal chart — which house each transiting planet occupies from the natal moon sign, and the effect of that transit.

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

Example response

{
  "success": true,
  "data": {
    "transits": [
      {
        "planet": "Jupiter",
        "currentSign": "Taurus",
        "natalHouseFromMoon": 7,
        "isRetrograde": false,
        "effect": "Favourable for partnerships and legal matters.",
        "significantTransit": true,
        "duration": "~1 year in this sign"
      },
      {
        "planet": "Saturn",
        "currentSign": "Pisces",
        "natalHouseFromMoon": 5,
        "isRetrograde": false,
        "effect": "Discipline required in creative and speculative areas.",
        "significantTransit": true,
        "duration": "~2.5 years in this sign"
      }
    ],
    "significantTransits": [
      {
        "type": "SadeSati",
        "phase": "peak",
        "description": "Sade Sati peak phase — Saturn transiting natal moon sign.",
        "duration": "~2.5 years per phase"
      }
    ]
  }
}

---

Sade Sati & Kantak Shani

POST /v1/sade-sati

Checks whether the person is currently in Sade Sati (7.5-year Saturn cycle over moon sign) or Kantak Shani (Saturn in 1st, 4th, 8th, or 10th house from moon). Returns phase, duration, and guidance.

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

Response

{
  "success": true,
  "data": {
    "sadeSati": {
      "isActive": true,
      "phase": "peak",
      "saturnSign": "Scorpio",
      "moonSign": "Scorpio",
      "startDate": "2023-01-17",
      "endDate": "2025-06-18",
      "guidance": "Focus on discipline, patience, and karmic lessons."
    },
    "kantakShani": {
      "isActive": false
    }
  }
}

Phase	Description
rising	Saturn one sign before moon sign
peak	Saturn in the same sign as natal moon
setting	Saturn one sign after moon sign