Find Returns
find_returnsFind the exact date and time when a celestial body returns to its natal position, enabling calculation of solar, lunar, and planetary returns for any birth chart.
Instructions
Find the exact moments a body returns to its natal longitude — solar returns (the astrological "birthday", one per year), lunar returns (one per ~27.3 days), or any planetary return (e.g. Saturn return, one per ~29.5 years).
Examples:
"My solar return in 2026, born 1990-03-15 15:45 Riga" -> { body: "Sun", natal_datetime: "1990-03-15T15:45", natal_timezone: "Europe/Riga", from_datetime: "2026-01-01", to_datetime: "2027-01-01" }
"When is my Saturn return?" -> body: "Saturn" with a multi-year window around ages 27–31.
To cast the full chart for a return moment, pass the returned datetime to compute_natal_chart with the person's current location.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Which body's return to find, e.g. "Sun", "Saturn". | |
| natal_datetime | Yes | Birth date and time. | |
| natal_timezone | No | IANA timezone the datetime is local to, e.g. "Europe/Riga" or "America/New_York". Omit when the datetime already carries Z or a UTC offset. | |
| from_datetime | Yes | Start of the search window. | |
| to_datetime | Yes | End of the search window (max 120 years after start). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| returns | Yes |