Return Charts
Calculate planetary return timing (with optional return chart output).
Overview
Returns compute the exact moment a body returns to its natal position, searched near a target datetime.
POST /predictive/returns
Calculate planetary return timing (Sun, Moon, and other bodies), with optional return chart output.
Request Body
{
body: "Sun" | "Moon" | string;
birth_datetime: { iso?: string };
target_datetime: { iso?: string };
location: {
latitude: { decimal: number };
longitude: { decimal: number };
timezone: { name?: string; iana_name?: string };
elevation?: number;
};
return_location?: {
latitude: { decimal: number };
longitude: { decimal: number };
timezone: { name?: string; iana_name?: string };
elevation?: number;
};
search_window_days?: number;
include_chart: boolean;
house_system?: string | null;
}
Example
curl -X POST https://api.astromcp.io/predictive/returns \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"body": "Sun",
"birth_datetime": { "iso": "1990-06-15T14:30:00Z" },
"target_datetime": { "iso": "2024-06-15T00:00:00Z" },
"location": {
"latitude": { "decimal": 40.7128 },
"longitude": { "decimal": -74.0060 },
"timezone": { "name": "UTC" }
},
"include_chart": true,
"house_system": "P",
"search_window_days": 5
}'
Interpreting Return Charts
Solar Return Analysis:
- Ascendant: General theme for the year
- Sun House: Area of focus
- Moon: Emotional needs
- Aspects to Natal: How the year relates to your natal chart
Lunar Return Analysis:
- Moon House: Monthly focus area
- Aspects: Emotional themes for the month
- Angles: Key events and timing
Use Cases
- Birthday planning: Understand yearly themes
- Relocation decisions: Compare returns for different locations
- Timing: Identify best months for specific activities
- Personal development: Track growth cycles
Related Endpoints
- Natal Charts - Original birth chart
- Transits - Current planetary positions
- Progressed Charts - Long-term evolution