Solar Return Context Endpoint #

`POST /api/v5/context/solar-return` #

📘 View Complete Example

Provides formatted astrological context for AI interpretations of Solar Return charts. This endpoint synthesizes the themes and structural alignments of the return chart into a structured summary, allowing an external AI to generate detailed yearly forecasts and birthday readings.

Request Body #

subject (object, required): The Natal Subject.

{
  "name": "John Doe",
  "year": 1990,
  "month": 1,
  "day": 1,
  "hour": 12,
  "minute": 0,
  "city": "London",
  "nation": "GB",
  "longitude": -0.1278,
  "latitude": 51.5074,
  "timezone": "Europe/London"
}

year (integer, required): The year for which to calculate the return (e.g., 2024 for the 2024-2025 birthday year).
month (integer, optional): Month (1-12) to start the search from.
day (integer, optional): Day (1-31) to start the search from. Defaults to 1.
return_location (object, optional): Location where the subject spends their birthday (relocation).
Computation options: active_points, active_aspects, distribution_method, custom_distribution_weights (identical to /api/v5/chart-data/solar-return). Rendering options such as theme, language, split_chart, transparent_background, show_house_position_comparison, show_cusp_position_comparison, show_degree_indicators, custom_title are not accepted here.

Complete Request Example #

{
  "subject": {
    "name": "John Doe",
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "city": "London",
    "nation": "GB",
    "lng": -0.1278,
    "lat": 51.5074,
    "tz_str": "Europe/London"
  },
  "year": 2024,
  "month": 1,
  "day": 1
}

Response Body #

status (string): “OK” on success.
context (string): The generated AI text interpretation of the solar return.
chart_data (object): The complete calculated solar return chart data.

Complete Response Example #

{
  "status": "OK",
  "context": "Solar Return Analysis for 2024...\nThe Ascendant of the return chart is in...",
  "chart_data": {
    "natal_subject": { ... },
    "return_subject": { ... },
    "aspects_list": [ ... ]
    // ... full return data
  }
}