get

/api/v1/ingress/houses

Find house cusp ingresses for Sun or Moon

Overview

Detect when the Moon or Sun crosses house cusps at a given location. House cusps are location- and time-dependent — they rotate with the Earth, completing a full rotation roughly once per sidereal day (~23.93 hours). Both the Moon and Sun cross all 12 cusps approximately once per day. **Range limits:** 7 days for Moon, 90 days for Sun.

Parameters

Name	Type	In	Required	Description
`startDate`	string	query	Yes	Start date in ISO format (YYYY-MM-DD)
`endDate`	string	query	Yes	End date in ISO format (YYYY-MM-DD)
`timezone`	string	query	No	IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.
`latitude`	string	query	Yes	Latitude in decimal degrees
`longitude`	string	query	Yes	Longitude in decimal degrees
`elevation`	string	query	No	Observer elevation in meters above sea level Default: `0`
`body`	string	query	No	Celestial body to track (only Sun and Moon are supported) Allowed: `SunMoon` Default: `Moon`
`houseSystem`	string	query	No	House system to use for cusp calculation Allowed: `PlacidusKochEqualWholeCampanusRegiomontanusMorinusPorphyryAlcabitiusTopocentricMeridianVehlowEqualNaturalGraduationSripati` Default: `Placidus`

Response

200 — List of house ingress events

body string required

startDate string required

endDate string required

houseSystem string required

latitude number required

longitude number required

count number required

ingresses array required

array of object

body string required
date string required
enteringHouse number required: House number being entered (1-12)
longitude number required: Body longitude at crossing
cuspLongitude number required: Cusp longitude at crossing
isAngle boolean required: Whether this crossing is at a major angle (ASC, MC, DESC, IC)
angleName string: Name of the angle, if applicable; Enum:
ASCMCDESCIC

Example Request

cURL

curl "https://api.almuten.io/api/v1/ingress/houses" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "body": "",
  "startDate": "",
  "endDate": "",
  "houseSystem": "",
  "latitude": 0,
  "longitude": 0,
  "count": 0,
  "ingresses": [
    {
      "body": "Moon",
      "date": "2025-06-15T13:27:18.999Z",
      "enteringHouse": 1,
      "longitude": 314.2558,
      "cuspLongitude": 314.2578,
      "isAngle": true,
      "angleName": "ASC"
    }
  ]
}