By topic / Planetary Returns API
Planetary Returns API: solar, lunar and planetary returns
Find the exact moment of a return for any year and place, get its chart, and turn it into a report: the year's theme, each planet's forecast and its aspects to the natal chart.
What people build with it
- Birthday reports
- Year-ahead forecasts
- Relocated returns
The endpoints
- Solar Return Chart
The exact moment the Sun returns to its natal position in a year, with the return chart cast at the birth place or at return_place.
POST /v1/western/western-solar-return
1 credit
- Solar Return Readings
The year's theme, a forecast for each planet in the return chart, and its aspects to the natal chart.
POST /v1/western/western-solar-return-report
3 credits
- Solar Return Report
The Western solar return for a year as one report: its moment, rising sign and Midheaven, the year's theme, a reading of each planet and its aspects to the natal chart.
POST /v1/reports/report-solar-return
10 credits
- Western Yearly Forecast
Year ahead from the solar return: the return moment and chart, the year's main transit themes with exact dates, and a summary.
POST /v1/western/western-yearly-forecast
10 credits
Common questions
- Can a return be cast for another city?
- Yes. Send the place where the person will spend their birthday.