Houses
GET /v1/houses — Compute house cusps for any of 22 house systems.
Houses
Compute house cusps, ascendant, midheaven, and related angles for a given location and time.
GET /v1/houses
POST /v1/housesCredit cost: 1
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
datetime | string | One of datetime or jd | — | ISO 8601 UTC datetime |
jd | number | One of datetime or jd | — | Julian Day in UT1 |
lat | number | Yes | — | Observer latitude in degrees |
lon | number | Yes | — | Observer longitude in degrees |
system | string | No | "placidus" | House system name or code |
sidereal | string | No | — | Ayanamsha name or ID for sidereal houses |
Response
{
"data": {
"system": "placidus",
"cusps": [
198.4521, 228.1234, 261.5678, 298.9012,
328.3456, 358.7890, 18.4521, 48.1234,
81.5678, 118.9012, 148.3456, 178.7890
],
"ascendant": 198.4521,
"midheaven": 118.9012,
"armc": 117.2345,
"vertex": 42.6789
},
"meta": { "..." }
}| Field | Type | Description |
|---|---|---|
system | string | House system used |
cusps | number[] | 12 house cusp longitudes in degrees (0–360) |
ascendant | number | Ascendant longitude |
midheaven | number | Midheaven (MC) longitude |
armc | number | ARMC (right ascension of the MC) in degrees |
vertex | number | Vertex longitude |
Examples
curl "https://api.morphemeris.com/v1/houses?datetime=2024-03-20T12:00:00Z&lat=40.7128&lon=-74.0060&system=placidus" \
-H "Authorization: Bearer morphemeris_live_YOUR_KEY"const res = await fetch(
"https://api.morphemeris.com/v1/houses?datetime=2024-03-20T12:00:00Z&lat=40.7128&lon=-74.0060&system=placidus",
{ headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();import requests
res = requests.get(
"https://api.morphemeris.com/v1/houses",
params={
"datetime": "2024-03-20T12:00:00Z",
"lat": 40.7128,
"lon": -74.0060,
"system": "placidus",
},
headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()See House Systems for all 22 supported systems.