get

/api/v1/eclipses/local

Get local solar eclipse visibility

Overview

Returns solar eclipses visible from a specific geographic location within a date range. Includes local obscuration, timing of phases, and Sun altitude at peak.

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.
`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`

Response

200 — List of locally visible solar eclipses

startDate string required

endDate string required

latitude number required

longitude number required

elevation number required

count number required

eclipses array required

array of object

kind string required
peakTime string required
peakAltitude number required
obscuration number required
partialBegin string required
partialEnd string required
totalBegin string
totalEnd string

Example Request

cURL

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

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "latitude": 0,
  "longitude": 0,
  "elevation": 0,
  "count": 0,
  "eclipses": [
    {
      "kind": "",
      "peakTime": "",
      "peakAltitude": 0,
      "obscuration": 0,
      "partialBegin": "",
      "partialEnd": "",
      "totalBegin": "",
      "totalEnd": ""
    }
  ]
}