https://json.astrologyapi.com/v1/solar_return_house_cuspsx-astrologyapi-keystringrequiredAPI access token used to authenticate requests. Send your access token in this custom header.
Accept-LanguagestringPreferred language for the response content. Supported: English - en, Spanish - es, Portuguese - pt, French - fr, Italian - it, German - de, Russian - ru.
dayintrequiredDate of birth, eg: 10
monthintrequiredMonth of birth, eg: 5
yearintrequiredYear of birth, eg: 1990
hourintrequiredHour of birth, eg: 19
minintrequiredMinute of birth, eg: 55
latfloatrequiredLatitude, eg: 19.2056
lonfloatrequiredLongitude, eg: 25.2056
tzonefloatrequiredTimezone, eg: 5.5
solar_yearintSolar Year, eg: 2025
house_typestringDefault : "placidus" // koch/topocentric/poryphry/equal_house/whole_sign
curl --location 'https://json.astrologyapi.com/v1/solar_return_house_cusps' \
--header 'Content-Type: application/json' \
--header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
--data '{
"day": 10,
"month": 5,
"year": 1990,
"hour": 19,
"min": 55,
"lat": 19.2056,
"lon": 25.2056,
"tzone": 5.5,
"solar_year": 2025,
"house_type": 2025
}'
Runs with sample data β no API key needed
{
"houses": [
{
"house": 1,
"sign": "Aries",
"degree": 13.25529
},
{
"house": 2,
"sign": "Taurus",
"degree": 43.01473
},
{
"house": 3,
"sign": "Gemini",
"degree": 68.55911
},
{
"house": 4,
"sign": "Cancer",
"degree": 93.78243
},
{
"house": 5,
"sign": "Leo",
"degree": 122.1002
},
{
"house": 6,
"sign": "Virgo",
"degree": 155.86703
},
{
"house": 7,
"sign": "Libra",
"degree": 193.25529
},
{
"house": 8,
"sign": "Scorpio",
"degree": 223.01473
},
{
"house": 9,
"sign": "Sagittarius",
"degree": 248.55911
},
{
"house": 10,
"sign": "Capricorn",
"degree": 273.78243
},
{
"house": 11,
"sign": "Aquarius",
"degree": 302.1002
},
{
"house": 12,
"sign": "Pisces",
"degree": 335.86703
}
],
"ascendant": 37.368916222730974,
"midheaven": 297.8960549871522,
"vertex": 194.57571878743278
}