eclipse

Next Eclipse

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.

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

Query parameters

eclipse_typestring

'solar', 'lunar', or 'any'

datestring nullable

ISO 8601 date to search after (e.g. 2026-01-01). Defaults to now if omitted.

jdnumber double nullable

Julian Day to search after (alternative to date). Defaults to now if omitted.

after_datestring nullable

Alias for 'date' — ISO 8601 date to search after (e.g. 2026-01-01). Defaults to now if omitted. If both 'date' and 'after_date' are given, 'date' wins.

Response

Next eclipse of the requested type after the given date

days_untilnumber required

Changes

No recorded changes to this operation across all 1 revision of this API.