get

/api/v1/eclipses/natal-impact

Calculate eclipse impacts on a natal chart

Overview

For each eclipse in the specified date range, determines which natal planets are closely aspected by the eclipse position and assigns a significance rating based on orb.

Parameters

Name	Type	In	Required	Description
`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`
`birthDate`	string	query	Yes	Birth date in YYYY-MM-DD format
`birthTime`	string	query	No	Birth time in HH:MM format (24h)
`startDate`	string	query	Yes	Start of eclipse search range in YYYY-MM-DD format
`endDate`	string	query	Yes	End of eclipse search range in YYYY-MM-DD format

Response

200 — Eclipse impacts on natal chart

birthDate string required

startDate string required

endDate string required

eclipseCount number required

impacts array required

array of object

eclipseDate string required

eclipseType string required

Enum:

solarlunar

eclipseLongitude number required

eclipseSign string required

impactedPlanets array required

array of object

body string required
natalLongitude number required
orb number required
significance string required: Enum:
highmoderatelow

Example Request

cURL

curl "https://api.almuten.io/api/v1/eclipses/natal-impact" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "birthDate": "",
  "startDate": "",
  "endDate": "",
  "eclipseCount": 0,
  "impacts": [
    {
      "eclipseDate": "",
      "eclipseType": "solar",
      "eclipseLongitude": 0,
      "eclipseSign": "",
      "impactedPlanets": [
        {
          "body": null,
          "natalLongitude": null,
          "orb": null,
          "significance": null
        }
      ]
    }
  ]
}