> 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/moon-phase-calendar.md).
# Moon Phase Calendar
Get a calendar of moon phases over a date range โ including each dayโs phase name, illumination percentage, and moon age.
### ๐งพ Overview โ Plan Ahead with a Moon Phase Calendar
This API returns a daily list of moon phases between two dates for any location.
## ๐ How to Get Moon Phase Calendar
To get Moon Phase Calendar, make a POST request to the following endpoint:
POST
**Headers**
| Name | Value |
| ------------- | ------------------ |
| Content-Type | `application/json` |
| Authorization | `Bearer ` |
**Body**
| Name | Type | Example | Description |
| ----- | ------- | ---------- | --------------------------------- |
| month | Integer | 4 | Enter valid month |
| year | Integer | 2025 | Enter valid year |
| 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": "Moon phases fetched successfully.",
"code": 200,
"type": "SUCCESS",
"data": {
"status": 1,
"month_phases": [
{
"date": "2025-04-01",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 35.8757,
"moon_age": 2,
"illumination": 4.46
},
{
"date": "2025-04-02",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 49.6809,
"moon_age": 3,
"illumination": 9.85
},
{
"date": "2025-04-03",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 63.1412,
"moon_age": 4,
"illumination": 17.04
},
{
"date": "2025-04-04",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 76.1988,
"moon_age": 5,
"illumination": 25.73
},
{
"date": "2025-04-05",
"phase_no": 3,
"phase_name": "First Quarter Moon",
"phase_degree": 88.8387,
"moon_age": 6,
"illumination": 35.5
},
{
"date": "2025-04-06",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 101.0801,
"moon_age": 7,
"illumination": 45.94
},
{
"date": "2025-04-07",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 112.965,
"moon_age": 8,
"illumination": 56.55
},
{
"date": "2025-04-08",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 124.5475,
"moon_age": 9,
"illumination": 66.87
},
{
"date": "2025-04-09",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 135.8856,
"moon_age": 10,
"illumination": 76.43
},
{
"date": "2025-04-10",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 147.0354,
"moon_age": 11,
"illumination": 84.8
},
{
"date": "2025-04-11",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 158.0477,
"moon_age": 12,
"illumination": 91.59
},
{
"date": "2025-04-12",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 168.9672,
"moon_age": 13,
"illumination": 96.52
},
{
"date": "2025-04-13",
"phase_no": 5,
"phase_name": "Full Moon",
"phase_degree": 179.8324,
"moon_age": 14,
"illumination": 100
},
{
"date": "2025-04-14",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 190.6778,
"moon_age": 15,
"illumination": 99.94
},
{
"date": "2025-04-15",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 201.5364,
"moon_age": 16,
"illumination": 98.28
},
{
"date": "2025-04-16",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 212.4421,
"moon_age": 17,
"illumination": 94.45
},
{
"date": "2025-04-17",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 223.4325,
"moon_age": 18,
"illumination": 88.62
},
{
"date": "2025-04-18",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 234.551,
"moon_age": 19,
"illumination": 81.04
},
{
"date": "2025-04-19",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 245.8475,
"moon_age": 20,
"illumination": 72.06
},
{
"date": "2025-04-20",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 257.3784,
"moon_age": 21,
"illumination": 62.09
},
{
"date": "2025-04-21",
"phase_no": 7,
"phase_name": "Last Quarter Moon",
"phase_degree": 269.2038,
"moon_age": 22,
"illumination": 51.57
},
{
"date": "2025-04-22",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 281.3825,
"moon_age": 23,
"illumination": 40.98
},
{
"date": "2025-04-23",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 293.9645,
"moon_age": 24,
"illumination": 30.8
},
{
"date": "2025-04-24",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 306.9805,
"moon_age": 25,
"illumination": 21.48
},
{
"date": "2025-04-25",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 320.429,
"moon_age": 26,
"illumination": 13.45
},
{
"date": "2025-04-26",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 334.2649,
"moon_age": 27,
"illumination": 7.07
},
{
"date": "2025-04-27",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 348.3922,
"moon_age": 28,
"illumination": 2.63
},
{
"date": "2025-04-28",
"phase_no": 1,
"phase_name": "New Moon",
"phase_degree": 2.6684,
"moon_age": 0,
"illumination": 0
},
{
"date": "2025-04-29",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 16.9214,
"moon_age": 1,
"illumination": 1.13
},
{
"date": "2025-04-30",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 30.9778,
"moon_age": 2,
"illumination": 4.46
}
],
"phases_change_list": [
{
"datetime": "2025-04-01 21:19:00",
"phase_no": 2,
"phase_name": "Waxing Crescent Moon",
"phase_degree": 45
},
{
"datetime": "2025-04-05 07:45:00",
"phase_no": 3,
"phase_name": "First Quarter Moon",
"phase_degree": 90
},
{
"datetime": "2025-04-09 03:37:00",
"phase_no": 4,
"phase_name": "Waxing Gibbous Moon",
"phase_degree": 135
},
{
"datetime": "2025-04-13 05:53:00",
"phase_no": 5,
"phase_name": "Full Moon",
"phase_degree": 180
},
{
"datetime": "2025-04-17 08:55:00",
"phase_no": 6,
"phase_name": "Waning Gibbous Moon",
"phase_degree": 225
},
{
"datetime": "2025-04-21 07:06:00",
"phase_no": 7,
"phase_name": "Last Quarter Moon",
"phase_degree": 270
},
{
"datetime": "2025-04-24 19:55:00",
"phase_no": 8,
"phase_name": "Waning Crescent Moon",
"phase_degree": 315
},
{
"datetime": "2025-04-28 01:02:00",
"phase_no": 1,
"phase_name": "New Moon",
"phase_degree": 0
}
]
},
"input": {
"lat": "25.0422777",
"lon": "83.6078512",
"tzone": "5.5"
},
"info": {
"timestamp_utc": "2025-06-07 13:21:27",
"version": "v1.0",
"credits_used": 1,
"response_time": 2911.29
}
}
```
{% 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": {
"lat": [
"Latitude is required."
],
"lon": [
"Longitude is required."
],
"tzone": [
"Timezone is required."
]
}
}
```
{% endtab %}
{% endtabs %}