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

# Next Visible Eclipse

`GET /eclipse/next-visible`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/eclipse/next-visible`
- 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 visible from specific coordinates. Planning tool for eclipse chasers.

## Query parameters

- `lat` number, required: Observer latitude
- `lon` number, required: Observer longitude
- `type` string: 'solar', 'lunar', or 'any'

## Response `200`

Next visible eclipse with local circumstances

- 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)