Sign in
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
}

Changes

Changed in 4 of the 13 revisions of this API.5103

  • 8ab5a768b52114See the full diff
    • ▲

      the data/returns/items/ response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ●

      removed the optional property data/returns/items/chart from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/returns/items/returnDate from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/returns/items/returnJd from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property data/returns/items/returnTime from the response with the 200 status

      response-optional-property-removed

  • dd3764875e7a1See the full diff
    • ○

      added the new optional request property allOf[ChartInput]/ayanamsa

      new-optional-request-property

  • e637d1a9911b2See the full diff
    • ●

      the allOf[ChartInput]/timezoneOffset request property's max was set to 14.00

      request-property-max-set

    • ●

      the allOf[ChartInput]/timezoneOffset request property's min was set to -14.00

      request-property-min-set

  • b0533bcc12c0442See the full diff
    • ▲

      the request property allOf[ChartInput]/latitude became not nullable

      request-property-became-not-nullable

    • ▲

      the request property allOf[ChartInput]/longitude became not nullable

      request-property-became-not-nullable

    • ▲

      the request property allOf[ChartInput]/latitude became required

      request-property-became-required

    • ▲

      the request property allOf[ChartInput]/longitude became required

      request-property-became-required

    • ●

      the allOf[ChartInput]/latitude request property's max was set to 90.00

      request-property-max-set

    • ●

      the allOf[ChartInput]/longitude request property's max was set to 180.00

      request-property-max-set

    • ●

      the allOf[ChartInput]/latitude request property's min was set to -90.00

      request-property-min-set

    • ●

      the allOf[ChartInput]/longitude request property's min was set to -180.00

      request-property-min-set

    • ○

      the latitude request property default value 0 was removed

      request-property-default-value-removed

    • ○

      the longitude request property default value 0 was removed

      request-property-default-value-removed