get

/api/v1/eclipses/lunar

Get lunar eclipses within a date range

Overview

Returns all lunar eclipses 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 lunar eclipses

startDate string required

endDate string required

count number required

eclipses array required

array of object

type string required: Enum:
lunar
kind string required: Enum:
penumbralpartialtotal
date string required
peakTime string required
obscuration number required
partialDurationMinutes number required
totalDurationMinutes number required
moonSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
moonLongitude number required

Example Request

cURL

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

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "count": 0,
  "eclipses": [
    {
      "type": "lunar",
      "kind": "penumbral",
      "date": "",
      "peakTime": "",
      "obscuration": 0,
      "partialDurationMinutes": 0,
      "totalDurationMinutes": 0,
      "moonSign": "Aries",
      "moonLongitude": 0
    }
  ]
}