get

/api/v1/eclipses/solar

Get solar eclipses within a date range

Overview

Returns all solar eclipses within the specified date range. Note: Visibility depends on geographic location.

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 solar eclipses

startDate string required

endDate string required

count number required

eclipses array required

array of object

type string required: Enum:
solar
kind string required: Enum:
partialannulartotalhybrid
date string required
peakTime string required
magnitude number required
sunSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
sunLongitude number required

Example Request

cURL

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

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "count": 0,
  "eclipses": [
    {
      "type": "solar",
      "kind": "partial",
      "date": "",
      "peakTime": "",
      "magnitude": 0,
      "sunSign": "Aries",
      "sunLongitude": 0
    }
  ]
}