get

/api/v1/eclipses/seasons/current

Get the current or next eclipse season

Overview

Returns the eclipse season the given date falls within, or the next upcoming eclipse season if no season is currently active.

Parameters

NameTypeInRequiredDescription
datestringqueryNo

Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.

timezonestringqueryNo

IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.

Response

200 — Current or next eclipse season

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/current" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "start": "2025-03-11",
  "end": "2025-04-15",
  "midpoint": "2025-03-29",
  "node": "north",
  "sunNodeSeparation": 0.45
}