get

/api/v1/ingress/houses/angles

Find angle crossings (ASC, MC, DESC, IC) for Sun or Moon

Overview

Detect when the Moon or Sun crosses major angles at a given location. Filters house ingresses to only show crossings at the four angles: - **ASC** (Ascendant, house 1 cusp) - **IC** (Imum Coeli, house 4 cusp) - **DESC** (Descendant, house 7 cusp) - **MC** (Midheaven, house 10 cusp) **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 angle crossing 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/angles" \
  -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"
    }
  ]
}