> For the complete documentation index, see [llms.txt](https://quantaapi.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://quantaapi.gitbook.io/docs/geo-api/lunar-eclipse.md).

# Lunar Eclipse

Get upcoming lunar eclipse information for any location — including visibility, eclipse type (Total, Partial, Penumbral), and exact timing — starting from a specific date.

### 🧾 Overview – Track Lunar Eclipses

This API tells you if and when a lunar eclipse will be visible from a given location. Just provide the coordinates and (optionally) a starting date — and you’ll get the next eclipse after that date.

## 🚀 How to Get Lunar Eclipse

To get Lunar Eclipse, make a POST request to the following endpoint:

<kbd><mark style="color:green;">POST<mark style="color:green;"></kbd><kbd><https://geo.quantaapi.com/api/v1/eclipse/lunar></kbd>

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Body**

| Name  | Type  | Example    | Description                       |
| ----- | ----- | ---------- | --------------------------------- |
| date  | Date  | 2025-04-12 | Returns eclipses after this date  |
| lat   | Float | 28.6138954 | Place Latitude                    |
| lon   | Float | 77.2090057 | Place Longitude                   |
| tzone | Float | 5.5        | Place timezone for the given date |

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "status": "success",
    "message": "Lunar eclipse fetched successfully.",
    "code": 200,
    "type": "SUCCESS",
    "data": {
        "type": "Total Lunar Eclipse",
        "date": "2025-09-07",
        "julian_day": "2460926.258182",
        "magnitude": "1.3621/2.3438",
        "saros": "saros 128/41",
        "greatest_eclipse": {
            "utc": "2025-09-07 18:11:46",
            "local": "2025-09-07 23:41:46"
        },
        "phases": [
            {
                "phase": "Partial Start",
                "time_utc": "2025-09-07 15:28:21",
                "time_local": "2025-09-07 20:58:21"
            },
            {
                "phase": "Total Start",
                "time_utc": "2025-09-07 16:27:02",
                "time_local": "2025-09-07 21:57:02"
            },
            {
                "phase": "Greatest Eclipse",
                "time_utc": "2025-09-07 17:30:42",
                "time_local": "2025-09-07 23:00:42"
            },
            {
                "phase": "Total End",
                "time_utc": "2025-09-07 18:52:50",
                "time_local": "2025-09-08 00:22:50"
            },
            {
                "phase": "Partial End",
                "time_utc": "2025-09-07 19:56:31",
                "time_local": "2025-09-08 01:26:31"
            },
            {
                "phase": "Penumbral End",
                "time_utc": "2025-09-07 20:55:05",
                "time_local": "2025-09-08 02:25:05"
            }
        ]
    },
    "input": {
        "lat": "25.0422777",
        "lon": "83.6078512",
        "tzone": "5.5"
    },
    "info": {
        "timestamp_utc": "2025-06-07 13:12:35",
        "version": "v1.0"
    }
}
```

{% endtab %}

{% tab title="401" %}

```json
{
    "status": "error",
    "message": "The provided authorization token is invalid or expired",
    "code": 401,
    "type": "AUTHORIZATION_INVALID"
}
```

{% endtab %}

{% tab title="422" %}

```json
{
    "status": "error",
    "message": "Validation Error",
    "code": 422,
    "type": "VALIDATION_ERROR",
    "errors": {
        "date": [
            "The date field is required."
        ],
        "lat": [
            "Latitude is required."
        ],
        "lon": [
            "Longitude is required."
        ],
        "tzone": [
            "Timezone is required."
        ]
    }
}
```

{% endtab %}
{% endtabs %}