Houses - Western Astrology

API Endpoint:

western/houses

Method:

POST

Full URL:

https://json.freeastrologyapi.com/western/houses


Request data
Parameter Data type Description Constraints Required
year Integer Year number, eg: 2023 Valid year Number Yes
month Integer Month number,with no leading zero eg: 7 or 8 valid month number Yes
date Integer Day number,with no leading zero eg: 5 or 6 valid date number Yes
hours Integer hours number,with no leading zero eg: 1 or 2 valid hours number Yes
minutes Integer minutes number,with no leading zero eg: 0 or 1 valid minutes number Yes
seconds Integer seconds number,with no leading zero eg: 0 or 1 valid seconds number Yes
latitude float latitude number, in the range from -90 to 90 Valid latitude Yes
longitude float longitude number, in the range from -180 to 180 valid longitude Yes
timezone float Timezone of birth location, eg: 5.5 valid timezone Yes
config Object Contains optional configuration values Optional No
observation_point String either topocentric or geocentric Optional No
ayanamsha String either tropical or sayana or lahiri Optional No
house_system String either Placidus or Koch or Whole Signs or Regiomontanus or Vehlow Optional No
language String either en or es or fr or pt or ru or de or ja or pl or tr Optional No


Sample Payload 



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "house_system": "Placidus", /* "Placidus","Koch","Whole Signs","Equal Houses","Regiomontanus","Vehlow" */
        "language": "en" /* en , te , es , fr , pt , ru , de ,  ja */
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "es"
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "fr"
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "pt"
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "ru"
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "de"
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "ja"
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "house_system": "Placidus", /* "Placidus","Koch","Whole Signs","Equal Houses","Regiomontanus","Vehlow" */
        "language": "pl" /* en , te , es , fr , pt , ru , de ,  ja, pl, tr */
    }
}



{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "house_system": "Placidus", /* "Placidus","Koch","Whole Signs","Equal Houses","Regiomontanus","Vehlow" */
        "language": "tr" /* en , te , es , fr , pt , ru , de ,  ja, pl, tr */
    }
}


Sample Code



$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/western/houses',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "tropical",
        "house_system": "Placidus",
        "language": "en"
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;



import requests
import json

url = "https://json.freeastrologyapi.com/western/houses"

payload = json.dumps({
  "year": 1998,
  "month": 3,
  "date": 3,
  "hours": 10,
  "minutes": 30,
  "seconds": 0,
  "latitude": 17.38405,
  "longitude": 78.45636,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "tropical",
    "house_system": "Placidus",
    "language": "en"
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)




var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/western/houses',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "tropical",
      "house_system": "Placidus",
      "language": "en"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});


Response data


{
  "statusCode": 200,
  "output": {
    "Houses": [
      {
        "House": 1,
        "degree": 52.47594854455679,
        "normDegree": 22.475948544556793,
        "zodiac_sign": {
          "number": 2,
          "name": {
            "en": "Taurus"
          }
        }
      },
      {
        "House": 2,
        "degree": 80.32161383326883,
        "normDegree": 20.321613833268827,
        "zodiac_sign": {
          "number": 3,
          "name": {
            "en": "Gemini"
          }
        }
      },
      {
        "House": 3,
        "degree": 105.40889300632585,
        "normDegree": 15.408893006325854,
        "zodiac_sign": {
          "number": 4,
          "name": {
            "en": "Cancer"
          }
        }
      },
      {
        "House": 4,
        "degree": 131.68659732012725,
        "normDegree": 11.686597320127248,
        "zodiac_sign": {
          "number": 5,
          "name": {
            "en": "Leo"
          }
        }
      },
      {
        "House": 5,
        "degree": 162.03624878632513,
        "normDegree": 12.036248786325132,
        "zodiac_sign": {
          "number": 6,
          "name": {
            "en": "Virgo"
          }
        }
      },
      {
        "House": 6,
        "degree": 197.03470626535696,
        "normDegree": 17.03470626535696,
        "zodiac_sign": {
          "number": 7,
          "name": {
            "en": "Libra"
          }
        }
      },
      {
        "House": 7,
        "degree": 232.4759485445568,
        "normDegree": 22.475948544556786,
        "zodiac_sign": {
          "number": 8,
          "name": {
            "en": "Scorpio"
          }
        }
      },
      {
        "House": 8,
        "degree": 260.3216138332688,
        "normDegree": 20.321613833268827,
        "zodiac_sign": {
          "number": 9,
          "name": {
            "en": "Sagittarius"
          }
        }
      },
      {
        "House": 9,
        "degree": 285.40889300632585,
        "normDegree": 15.408893006325854,
        "zodiac_sign": {
          "number": 10,
          "name": {
            "en": "Capricorn"
          }
        }
      },
      {
        "House": 10,
        "degree": 311.68659732012725,
        "normDegree": 11.686597320127248,
        "zodiac_sign": {
          "number": 11,
          "name": {
            "en": "Aquarius"
          }
        }
      },
      {
        "House": 11,
        "degree": 342.0362487863252,
        "normDegree": 12.036248786325189,
        "zodiac_sign": {
          "number": 12,
          "name": {
            "en": "Pisces"
          }
        }
      },
      {
        "House": 12,
        "degree": 17.034706265356956,
        "normDegree": 17.034706265356956,
        "zodiac_sign": {
          "number": 1,
          "name": {
            "en": "Aries"
          }
        }
      }
    ]
  }
}



{
  "statusCode": 200,
  "output": {
    "Houses": [
      {
        "House": 1,
        "degree": 52.47594854455679,
        "normDegree": 22.475948544556793,
        "zodiac_sign": {
          "number": 2,
          "name": {
            "en": "Taurus",
            "es": "Tauro"
          }
        }
      },
      {
        "House": 2,
        "degree": 80.32161383326883,
        "normDegree": 20.321613833268827,
        "zodiac_sign": {
          "number": 3,
          "name": {
            "en": "Gemini",
            "es": "Géminis"
          }
        }
      },
      {
        "House": 3,
        "degree": 105.40889300632585,
        "normDegree": 15.408893006325854,
        "zodiac_sign": {
          "number": 4,
          "name": {
            "en": "Cancer",
            "es": "Cáncer"
          }
        }
      },
      {
        "House": 4,
        "degree": 131.68659732012725,
        "normDegree": 11.686597320127248,
        "zodiac_sign": {
          "number": 5,
          "name": {
            "en": "Leo",
            "es": "Leo"
          }
        }
      },
      {
        "House": 5,
        "degree": 162.03624878632513,
        "normDegree": 12.036248786325132,
        "zodiac_sign": {
          "number": 6,
          "name": {
            "en": "Virgo",
            "es": "Virgo"
          }
        }
      },
      {
        "House": 6,
        "degree": 197.03470626535696,
        "normDegree": 17.03470626535696,
        "zodiac_sign": {
          "number": 7,
          "name": {
            "en": "Libra",
            "es": "Libra"
          }
        }
      },
      {
        "House": 7,
        "degree": 232.4759485445568,
        "normDegree": 22.475948544556786,
        "zodiac_sign": {
          "number": 8,
          "name": {
            "en": "Scorpio",
            "es": "Escorpio"
          }
        }
      },
      {
        "House": 8,
        "degree": 260.3216138332688,
        "normDegree": 20.321613833268827,
        "zodiac_sign": {
          "number": 9,
          "name": {
            "en": "Sagittarius",
            "es": "Sagitario"
          }
        }
      },
      {
        "House": 9,
        "degree": 285.40889300632585,
        "normDegree": 15.408893006325854,
        "zodiac_sign": {
          "number": 10,
          "name": {
            "en": "Capricorn",
            "es": "Capricornio"
          }
        }
      },
      {
        "House": 10,
        "degree": 311.68659732012725,
        "normDegree": 11.686597320127248,
        "zodiac_sign": {
          "number": 11,
          "name": {
            "en": "Aquarius",
            "es": "Acuario"
          }
        }
      },
      {
        "House": 11,
        "degree": 342.0362487863252,
        "normDegree": 12.036248786325189,
        "zodiac_sign": {
          "number": 12,
          "name": {
            "en": "Pisces",
            "es": "Piscis"
          }
        }
      },
      {
        "House": 12,
        "degree": 17.034706265356956,
        "normDegree": 17.034706265356956,
        "zodiac_sign": {
          "number": 1,
          "name": {
            "en": "Aries",
            "es": "Aries"
          }
        }
      }
    ]
  }
}



{
  "statusCode": 200,
  "output": {
    "Houses": [
      {
        "House": 1,
        "degree": 52.47594854455679,
        "normDegree": 22.475948544556793,
        "zodiac_sign": {
          "number": 2,
          "name": {
            "en": "Taurus",
            "fr": "Taureau"
          }
        }
      },
      {
        "House": 2,
        "degree": 80.32161383326883,
        "normDegree": 20.321613833268827,
        "zodiac_sign": {
          "number": 3,
          "name": {
            "en": "Gemini",
            "fr": "Gémeaux"
          }
        }
      },
      {
        "House": 3,
        "degree": 105.40889300632585,
        "normDegree": 15.408893006325854,
        "zodiac_sign": {
          "number": 4,
          "name": {
            "en": "Cancer",
            "fr": "Cancer"
          }
        }
      },
      {
        "House": 4,
        "degree": 131.68659732012725,
        "normDegree": 11.686597320127248,
        "zodiac_sign": {
          "number": 5,
          "name": {
            "en": "Leo",
            "fr": "Lion"
          }
        }
      },
      {
        "House": 5,
        "degree": 162.03624878632513,
        "normDegree": 12.036248786325132,
        "zodiac_sign": {
          "number": 6,
          "name": {
            "en": "Virgo",
            "fr": "Vierge"
          }
        }
      },
      {
        "House": 6,
        "degree": 197.03470626535696,
        "normDegree": 17.03470626535696,
        "zodiac_sign": {
          "number": 7,
          "name": {
            "en": "Libra",
            "fr": "Balance"
          }
        }
      },
      {
        "House": 7,
        "degree": 232.4759485445568,
        "normDegree": 22.475948544556786,
        "zodiac_sign": {
          "number": 8,
          "name": {
            "en": "Scorpio",
            "fr": "Scorpion"
          }
        }
      },
      {
        "House": 8,
        "degree": 260.3216138332688,
        "normDegree": 20.321613833268827,
        "zodiac_sign": {
          "number": 9,
          "name": {
            "en": "Sagittarius",
            "fr": "Sagittaire"
          }
        }
      },
      {
        "House": 9,
        "degree": 285.40889300632585,
        "normDegree": 15.408893006325854,
        "zodiac_sign": {
          "number": 10,
          "name": {
            "en": "Capricorn",
            "fr": "Capricorne"
          }
        }
      },
      {
        "House": 10,
        "degree": 311.68659732012725,
        "normDegree": 11.686597320127248,
        "zodiac_sign": {
          "number": 11,
          "name": {
            "en": "Aquarius",
            "fr": "Verseau"
          }
        }
      },
      {
        "House": 11,
        "degree": 342.0362487863252,
        "normDegree": 12.036248786325189,
        "zodiac_sign": {
          "number": 12,
          "name": {
            "en": "Pisces",
            "fr": "Poissons"
          }
        }
      },
      {
        "House": 12,
        "degree": 17.034706265356956,
        "normDegree": 17.034706265356956,
        "zodiac_sign": {
          "number": 1,
          "name": {
            "en": "Aries",
            "fr": "Bélier"
          }
        }
      }
    ]
  }
}