---
title: "Lunar Eclipse Global Circumstances"
method: GET
path: "/eclipse/lunar/global"
tags: ["eclipse"]
---

# Lunar Eclipse Global Circumstances

`GET /eclipse/lunar/global`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/eclipse/lunar/global`
- 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`

Lunar eclipse visibility with contact times (penumbral, partial, total). Safe to view without eye protection. 🤖 AI-optimized output available — add `output_format=llm` to reduce payload ~55%.

## Query parameters

- `date` string, nullable
- `jd` number, double, nullable
- `delta_t_model` string
- `output_format` string

## Response `200`

Lunar eclipse global circumstances

- LunarEclipseGlobalResponse
  - `contact_times` LunarContactTimes, required
    - `duration_minutes` number
    - `maximum` string, required
    - `penumbral_end` string
    - `penumbral_magnitude` number
    - `penumbral_start` string
    - `totality_end` string
    - `totality_start` string
    - `umbral_end` string
    - `umbral_magnitude` number
    - `umbral_start` string
  - `eclipse_classification` EclipseClassification, required
    - `central_duration_seconds` number
    - `gamma` number, required
    - `greatest_magnitude` number
    - `inex_series` integer
    - `kind` 'solar' | 'lunar', required
    - `saros_member` integer
    - `saros_series` integer
    - `type` 'total' | 'annular' | 'hybrid' | 'partial' | 'penumbral', required
  - `meta` CalculationMeta, required
    - `calculation_precision` string
    - `delta_t_model` string, required
    - `delta_t_seconds` number, required
    - `delta_t_uncertainty` number, required
    - `ephemeris` string, required
    - `julian_day` number, double, required
  - `safety` SafetyWarnings
    - `baileys_beads_visible` boolean
    - `corona_visible_duration` string
    - `eye_protection_required` boolean, required
    - `partial_phase_duration` string
    - `path_uncertainty_note` string
  - `uncertainty` UncertaintyInfo
    - `confidence` 'high' | 'medium' | 'low' | 'historical', required
    - `delta_t_uncertainty_seconds` number, required
    - `path_uncertainty_km` number
    - `timing_uncertainty` string

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