---
title: "Next Eclipse"
method: GET
path: "/eclipse/next"
tags: ["eclipse"]
---

# Next Eclipse

`GET /eclipse/next`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/eclipse/next`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-OpenEphemeris-API-Key`
  - API key in header `X-API-Key`
  - API key in header `X-Service-Key`

Find the next solar or lunar eclipse anywhere on Earth after a given date — a forward search, not a point-in-time lookup. No location required; for local visibility and contact times at a specific place, use /eclipse/next-visible instead.

## Query parameters

- `eclipse_type` string: 'solar', 'lunar', or 'any'
- `date` string, nullable
- `jd` number, double, nullable
- `after_date` string, nullable

## Response `200`

Next eclipse of the requested type after the given date

- NextVisibleResponse
  - `days_until` number, required
  - `eclipse` EclipseSummary, required
    - `date` string, required
    - `gamma` number
    - `jd` number, double, required
    - `kind` 'solar' | 'lunar', required
    - `magnitude` number
    - `type` 'total' | 'annular' | 'hybrid' | 'partial' | 'penumbral'
  - `local_circumstances` LocalCircumstances
    - `duration_seconds` number
    - `first_contact` string
    - `fourth_contact` string
    - `magnitude` number, required
    - `max_eclipse` string, required
    - `obscuration` number
    - `second_contact` string
    - `sun_altitude` number
    - `sun_azimuth` number
    - `third_contact` string
    - `type` 'total' | 'annular' | 'hybrid' | 'partial' | 'penumbral', required

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)