get

/api/v1/eclipses/seasons

Find eclipse seasons in a date range

Overview

Returns eclipse seasons (periods when the Sun is within 18.5 degrees of a lunar node, making eclipses possible) within the specified date range.

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.

Response

200 — List of eclipse seasons

startDate string required

endDate string required

count number required

seasons array required

array of object

start string required: ISO date when the eclipse season begins
end string required: ISO date when the eclipse season ends
midpoint string required: ISO date of closest Sun-Node approach
node string required: Which lunar node the Sun is near; Enum:
northsouth
sunNodeSeparation number required: Angular distance between Sun and node at midpoint (degrees)

Example Request

cURL

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

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "count": 0,
  "seasons": [
    {
      "start": "2025-03-11",
      "end": "2025-04-15",
      "midpoint": "2025-03-29",
      "node": "north",
      "sunNodeSeparation": 0.45
    }
  ]
}