Calculations

Find the next solar or lunar return and its chart

Current first solar or lunar longitude return beyond after +1 millisecond, subject to the documented numerical equality allowance, followed by a physical chart at that root. after may precede birth. Both civil dates 1800–2200; birth UTC and the complete fixed search window (Sun 370 TT days, Moon 32 TT days) must stay in UTC 1800–2200; no window clipping. Tropical/Equal defaults. Sidereal uses each ephemeris date's mean P03 ayanamsa with nutation retained. Return location defaults to birth coordinates and changes houses, not the return instant. No Placidus, arbitrary bodies/targets/search tolerances, cycles or predictions. All admitted attempts use one standard quota unit, including free plans. No practitioner sign-off is claimed.

Each admitted request reserves one monthly usage unit before route validation or engine work; failed or timed-out admitted attempts are not refunded. Do not automatically retry. Historical mode uses an explicit BCE/CE date object and UT1 conventions. Its response is the versioned historical envelope, not the modern UTC envelope. Read result for calculation fields and metadata for limits and uncertainty.

post/api/astro/returns

Request

  • Base URL: https://api.cosmicephemeris.com
  • URL: https://api.cosmicephemeris.com/api/astro/returns
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

OR

Response

Successful calculation. Field nesting is specific to this route.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.