Sign in
latestOpenAPI 3.1.02026-08-237602082.8 MB

529d7d36d7d6

Prognostics

Planetary Return

Find all returns of any planet to its natal longitude within a given year. Returns full charts for each return.

post/planetary-return

Request body

datestring required
timestring required
timezoneOffsetnumber nullable

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

latitudenumber required
longitudenumber required
houseSystemstring
namestring
citystring
zodiacType'tropical' | 'sidereal'
ayanamsaIdnumber nullable
ayanamsa'fagan-bradley' | 'lahiri' | 'de-luce' | 'raman' | 'krishnamurti' | 'kp' | 'yukteshwar' | 'jn-bhasin' | 'true-citra' | 'djwhal-khul'

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

cosmogramboolean
planetIdnumber nullable required
yearnumber nullable required
locationLatnumber nullable
locationLngnumber nullable

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}