Endpoint

Solar return

Chart for the Sun's return. Nested natal object — not birth_year fields.

POST /api/v1/solar-return

Request

{
  "location": "natal",
  "natal": {
    "day": 15,
    "hour": 14,
    "latitude": 40.7128,
    "longitude": -74.006,
    "minute": 30,
    "month": 5,
    "year": 1990
  },
  "year": 2026
}

Parameters

Field	Required	Notes
natal	yes	year/month/day/hour/minute plus coords or location
year	no	Default current year, range 1900–2100
location	no	natal (default) or current
current_latitude, current_longitude	if current	Relocation

Result (minimal envelope): return_datetime, natal_sun_longitude, location, planets, houses, ascendant, midheaven, aspects, plus top-level year.