---
title: "Eclipses"
method: POST
path: "/eclipses"
tags: ["Calendar & Cycles"]
---

# Eclipses

`POST /eclipses`

Find solar and lunar eclipses within a given year or multi-year range. Returns type, date, and geographic visibility data.

## Request body

- Eclipses
  - `year` number, nullable, required
  - `yearsRange` number

## Response `200`

Successful calculation

- object
  - `ok` boolean
  - `data` object
    - `eclipses` object[], nullable
      - `kind` string, nullable
      - `type` string, nullable
      - `maxJd` number, nullable
      - `maxDate` string, nullable
      - `beginJd` number, nullable
      - `beginDate` string, nullable
      - `endJd` number, nullable
      - `endDate` string, nullable
      - `longitude` number, nullable
      - `signIndex` number, nullable
      - `totalityBeginJd` number, nullable
      - `totalityEndJd` number, nullable

## Other responses

- `400` — Validation error
- `401` — Missing or invalid API key

## Changes

- **2026-08-24** `8ab5a768b521` — 4 warning, 10 info
  - removed the optional property `data/eclipses/items/date` from the response with the `200` status
  - removed the optional property `data/eclipses/items/jd` from the response with the `200` status
  - removed the optional property `data/eclipses/items/saros` from the response with the `200` status
  - removed the optional property `data/eclipses/items/subtype` from the response with the `200` status
  - …10 more
- **2026-08-23** `6828e5609564` — 1 breaking, 2 warning
  - the request property `yearsRange` became not nullable
  - the `yearsRange` request property's max was set to `20.00`
  - the `yearsRange` request property's min was set to `0.00`

[Change history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/eclipses/post.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) · [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/astroway/astroway-calculation-api/revisions/8ab5a768b521/schema)