AstroAsk Docs
API referenceWestern astrologyV1WesternSolar return

POST /v1/western/solar-return

Solar return chart for any target year.

POST
/v1/western/solar-return

Authorization

ApiKeyAuth
X-API-Key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/western/solar-return" \  -H "Content-Type: application/json" \  -d '{    "date": "1990-01-15T10:30:00"  }'
{  "success": true,  "data": {    "targetYear": 2026,    "exactDate": "2026-01-15T04:16:45.984Z",    "positions": [      {        "planet": "Sun",        "tropicalLongitude": 295.0146176435054,        "latitude": -0.00014702360606438678,        "speed": 1.0188309260587731,        "isRetrograde": false,        "sign": 9,        "signName": "Capricorn",        "degreeInSign": 25.014617643505403,        "element": "Earth",        "modality": "Cardinal",        "dignity": "Peregrine"      },      {        "planet": "Moon",        "tropicalLongitude": 254.22530246825477,        "latitude": -5.111345742466682,        "speed": 11.938449790087347,        "isRetrograde": false,        "sign": 8,        "signName": "Sagittarius",        "degreeInSign": 14.225302468254768,        "element": "Fire",        "modality": "Mutable",        "dignity": "Peregrine"      },      {        "planet": "Mercury",        "tropicalLongitude": 290.919669508124,        "latitude": -1.7939073274646062,        "speed": 1.6218618712171167,        "isRetrograde": false,        "sign": 9,        "signName": "Capricorn",        "degreeInSign": 20.919669508124002,        "element": "Earth",        "modality": "Cardinal",        "dignity": "Peregrine"      },      {        "planet": "Venus",        "tropicalLongitude": 297.0424906970761,        "latitude": -0.9840434516756728,        "speed": 1.257651753579544,        "isRetrograde": false,        "sign": 9,        "signName": "Capricorn",        "degreeInSign": 27.04249069707612,        "element": "Earth",        "modality": "Cardinal",        "dignity": "Peregrine"      },      {        "planet": "Mars",        "tropicalLongitude": 293.6185023793305,        "latitude": -0.9714941249393642,        "speed": 0.7753266576277836,        "isRetrograde": false,        "sign": 9,        "signName": "Capricorn",        "degreeInSign": 23.618502379330494,        "element": "Earth",        "modality": "Cardinal",        "dignity": "Exaltation"      },      {        "planet": "Jupiter",        "tropicalLongitude": 109.45976552985672,        "latitude": 0.2719902108098404,        "speed": -0.1337464052406626,        "isRetrograde": true,        "sign": 3,        "signName": "Cancer",        "degreeInSign": 19.459765529856725,        "element": "Water",        "modality": "Cardinal",        "dignity": "Exaltation"      },      {        "planet": "Saturn",        "tropicalLongitude": 357.14220618786794,        "latitude": -2.2153302991602826,        "speed": 0.07876723662596788,        "isRetrograde": false,        "sign": 11,        "signName": "Pisces",        "degreeInSign": 27.14220618786794,        "element": "Water",        "modality": "Mutable",        "dignity": "Peregrine"      },      {        "planet": "Uranus",        "tropicalLongitude": 57.631391366333844,        "latitude": -0.19348343869072754,        "speed": -0.017007845282762266,        "isRetrograde": true,        "sign": 1,        "signName": "Taurus",        "degreeInSign": 27.631391366333844,        "element": "Earth",        "modality": "Fixed",        "dignity": "Peregrine"      },      {        "planet": "Neptune",        "tropicalLongitude": 359.73713278246896,        "latitude": -1.3238385397127501,        "speed": 0.01997838609846729,        "isRetrograde": false,        "sign": 11,        "signName": "Pisces",        "degreeInSign": 29.73713278246896,        "element": "Water",        "modality": "Mutable",        "dignity": "Domicile"      },      {        "planet": "Pluto",        "tropicalLongitude": 303.15918849286277,        "latitude": -3.782957881483056,        "speed": 0.03181685472011997,        "isRetrograde": false,        "sign": 10,        "signName": "Aquarius",        "degreeInSign": 3.159188492862768,        "element": "Air",        "modality": "Fixed",        "dignity": "Peregrine"      },      {        "planet": "Chiron",        "tropicalLongitude": 22.672610833939302,        "latitude": 0.4783380974853958,        "speed": 0.01178710764663773,        "isRetrograde": false,        "sign": 0,        "signName": "Aries",        "degreeInSign": 22.672610833939302,        "element": "Fire",        "modality": "Cardinal",        "dignity": "Peregrine"      },      {        "planet": "NorthNode",        "tropicalLongitude": 340.00368993760685,        "latitude": 0,        "speed": -0.13730298687652054,        "isRetrograde": true,        "sign": 11,        "signName": "Pisces",        "degreeInSign": 10.00368993760685,        "element": "Water",        "modality": "Mutable",        "dignity": "Peregrine"      },      {        "planet": "SouthNode",        "tropicalLongitude": 160.00368993760685,        "latitude": 0,        "speed": -0.13730298687652054,        "isRetrograde": true,        "sign": 5,        "signName": "Virgo",        "degreeInSign": 10.00368993760685,        "element": "Earth",        "modality": "Mutable",        "dignity": "Peregrine"      }    ],    "houses": [      {        "number": 1,        "sign": 8,        "signName": "Sagittarius",        "cuspDegree": 268.92169750235325,        "planetsInHouse": [          "Sun",          "Mercury",          "Mars"        ],        "rulerPlanet": "Jupiter"      },      {        "number": 2,        "sign": 9,        "signName": "Capricorn",        "cuspDegree": 296.7896932641921,        "planetsInHouse": [          "Venus",          "Pluto"        ],        "rulerPlanet": "Saturn"      },      {        "number": 3,        "sign": 10,        "signName": "Aquarius",        "cuspDegree": 326.59746938826765,        "planetsInHouse": [          "Saturn",          "NorthNode"        ],        "rulerPlanet": "Uranus"      },      {        "number": 4,        "sign": 11,        "signName": "Pisces",        "cuspDegree": 358.7190948161475,        "planetsInHouse": [          "Neptune",          "Chiron"        ],        "rulerPlanet": "Neptune"      },      {        "number": 5,        "sign": 1,        "signName": "Taurus",        "cuspDegree": 30.955648002143903,        "planetsInHouse": [          "Uranus"        ],        "rulerPlanet": "Venus"      },      {        "number": 6,        "sign": 2,        "signName": "Gemini",        "cuspDegree": 60.96490599002766,        "planetsInHouse": [],        "rulerPlanet": "Mercury"      },      {        "number": 7,        "sign": 2,        "signName": "Gemini",        "cuspDegree": 88.92169750235331,        "planetsInHouse": [          "Jupiter"        ],        "rulerPlanet": "Mercury"      },      {        "number": 8,        "sign": 3,        "signName": "Cancer",        "cuspDegree": 116.78969326419212,        "planetsInHouse": [],        "rulerPlanet": "Moon"      },      {        "number": 9,        "sign": 4,        "signName": "Leo",        "cuspDegree": 146.59746938826765,        "planetsInHouse": [          "SouthNode"        ],        "rulerPlanet": "Sun"      },      {        "number": 10,        "sign": 5,        "signName": "Virgo",        "cuspDegree": 178.7190948161475,        "planetsInHouse": [],        "rulerPlanet": "Mercury"      },      {        "number": 11,        "sign": 7,        "signName": "Scorpio",        "cuspDegree": 210.9556480021439,        "planetsInHouse": [],        "rulerPlanet": "Pluto"      },      {        "number": 12,        "sign": 8,        "signName": "Sagittarius",        "cuspDegree": 240.96490599002766,        "planetsInHouse": [          "Moon"        ],        "rulerPlanet": "Jupiter"      }    ],    "ascendant": 268.9216975023533,    "midheaven": 178.71909481614753  }}