Moon Phase Calendar

Generate a monthly lunar overview with the Moon Phase Calendar API, returning day-by-day moon phases, illumination, and exact phase-change timestamps for the selected month and location.

Step by Step Moon Phase Calendar API Postman Testing Integration

View the Postman Testing Guide

Supported Language Codes

Support Article URL: https://support.divineapi.com/general-api-support/translating-a-natal-apis-into-a-different-language

Code	Language
en	English
hi	Hindi
pt	Portuguese
fr	French
de	German
ja	Japanese
tr	Turkish
ru	Russian
it	Italian
es	Spanish
nl	Dutch
pl	Polish

Guide: These languages are supported by this API. You can use them by passing lan in the request body with the value of the language.

API Endpoint

POST https://astroapi-4.divineapi.com/western-api/v1/moon-phase-calendar

Returns Moon Phase Calendar in the response.

Headers

Name	Type	Description
Authorization*	String	Your API Access TokenExample: `Bearer {token}`

Request Body

Name	Type	Description
api_key*	String	Your API key
month*	Integer	Month for which you want the moon phase calendar, e.g., `04`
year*	Integer	Year for which you want the moon phase calendar, e.g., `2025`
place*	String	Place name, e.g., `New Delhi`
lat*	Float	Latitude, e.g., `28.7041`
lon*	Float	Longitude, e.g., `77.1025`
tzone*	Float	Timezone, e.g., `5.5` (Timezone List)
lan	String	Language code as per the table above. Default is `en`.

200: OK Moon Phase Calendar Fetched Successfully

{
    "success": 1,
    "data": {
        "month_phases": [
            {
                "date": "2025-04-01",
                "phase_no": 2,
                "phase_name": "Waxing Crescent Moon",
                "phase_degree": 32.6735,
                "moon_age": 2,
                "illumination": 4.46
            },
            {
                "date": "2025-04-02",
                "phase_no": 2,
                "phase_name": "Waxing Crescent Moon",
                "phase_degree": 46.5447,
                "moon_age": 3,
                "illumination": 9.85
            },
            {
                "date": "2025-04-03",
                "phase_no": 2,
                "phase_name": "Waxing Crescent Moon",
                "phase_degree": 60.0906,
                "moon_age": 4,
                "illumination": 17.04
            },
            {
                "date": "2025-04-04",
                "phase_no": 2,
                "phase_name": "Waxing Crescent Moon",
                "phase_degree": 73.2433,
                "moon_age": 5,
                "illumination": 25.73
            },
            {
                "date": "2025-04-05",
                "phase_no": 3,
                "phase_name": "First Quarter Moon",
                "phase_degree": 85.9783,
                "moon_age": 6,
                "illumination": 35.5
            },
            {
                "date": "2025-04-06",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 98.308,
                "moon_age": 7,
                "illumination": 45.94
            },
            {
                "date": "2025-04-07",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 110.2699,
                "moon_age": 8,
                "illumination": 56.55
            },
            {
                "date": "2025-04-08",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 121.9165,
                "moon_age": 9,
                "illumination": 66.87
            },
            {
                "date": "2025-04-09",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 133.3055,
                "moon_age": 10,
                "illumination": 76.43
            },
            {
                "date": "2025-04-10",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 144.4938,
                "moon_age": 11,
                "illumination": 84.8
            },
            {
                "date": "2025-04-11",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 155.5335,
                "moon_age": 12,
                "illumination": 91.59
            },
            {
                "date": "2025-04-12",
                "phase_no": 4,
                "phase_name": "Waxing Gibbous Moon",
                "phase_degree": 166.4707,
                "moon_age": 13,
                "illumination": 96.52
            },
            {
                "date": "2025-04-13",
                "phase_no": 5,
                "phase_name": "Full Moon",
                "phase_degree": 177.3452,
                "moon_age": 14,
                "illumination": 100
            },
            {
                "date": "2025-04-14",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 188.1924,
                "moon_age": 15,
                "illumination": 99.94
            },
            {
                "date": "2025-04-15",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 199.0452,
                "moon_age": 16,
                "illumination": 98.28
            },
            {
                "date": "2025-04-16",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 209.937,
                "moon_age": 17,
                "illumination": 94.45
            },
            {
                "date": "2025-04-17",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 220.9043,
                "moon_age": 18,
                "illumination": 88.62
            },
            {
                "date": "2025-04-18",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 231.9892,
                "moon_age": 19,
                "illumination": 81.04
            },
            {
                "date": "2025-04-19",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 243.24,
                "moon_age": 20,
                "illumination": 72.06
            },
            {
                "date": "2025-04-20",
                "phase_no": 6,
                "phase_name": "Waning Gibbous Moon",
                "phase_degree": 254.7118,
                "moon_age": 21,
                "illumination": 62.09
            },
            {
                "date": "2025-04-21",
                "phase_no": 7,
                "phase_name": "Last Quarter Moon",
                "phase_degree": 266.4642,
                "moon_age": 22,
                "illumination": 51.57
            },
            {
                "date": "2025-04-22",
                "phase_no": 8,
                "phase_name": "Waning Crescent Moon",
                "phase_degree": 278.5569,
                "moon_age": 23,
                "illumination": 40.98
            },
            {
                "date": "2025-04-23",
                "phase_no": 8,
                "phase_name": "Waning Crescent Moon",
                "phase_degree": 291.043,
                "moon_age": 24,
                "illumination": 30.8
            },
            {
                "date": "2025-04-24",
                "phase_no": 8,
                "phase_name": "Waning Crescent Moon",
                "phase_degree": 303.9585,
                "moon_age": 25,
                "illumination": 21.48
            },
            {
                "date": "2025-04-25",
                "phase_no": 8,
                "phase_name": "Waning Crescent Moon",
                "phase_degree": 317.3106,
                "moon_age": 26,
                "illumination": 13.45
            },
            {
                "date": "2025-04-26",
                "phase_no": 8,
                "phase_name": "Waning Crescent Moon",
                "phase_degree": 331.0647,
                "moon_age": 27,
                "illumination": 7.07
            },
            {
                "date": "2025-04-27",
                "phase_no": 8,
                "phase_name": "Waning Crescent Moon",
                "phase_degree": 345.1364,
                "moon_age": 28,
                "illumination": 2.63
            },
            {
                "date": "2025-04-28",
                "phase_no": 1,
                "phase_name": "New Moon",
                "phase_degree": 359.3929,
                "moon_age": 0,
                "illumination": 0
            },
            {
                "date": "2025-04-29",
                "phase_no": 2,
                "phase_name": "Waxing Crescent Moon",
                "phase_degree": 13.6668,
                "moon_age": 1,
                "illumination": 1.13
            },
            {
                "date": "2025-04-30",
                "phase_no": 2,
                "phase_name": "Waxing Crescent Moon",
                "phase_degree": 27.7824,
                "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
            }
        ]
    }
}

Example Integrations

Below are examples of how you might call this method via cURL, NodeJS, JavaScript (jQuery AJAX), and Python.

cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v1/moon-phase-calendar' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'month="04"' \
--form 'year="2025"' \
--form 'place="New Delhi, India"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"'

NodeJS

var request = require('request');

var options = {
  method: 'POST',
  url: 'https://astroapi-4.divineapi.com/western-api/v1/moon-phase-calendar',
  headers: {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'month': '04',
    'year': '2025',
    'place': 'New Delhi, India',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en'
  }
};

request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript (jQuery AJAX)

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("month", "04");
form.append("year", "2025");
form.append("place", "New Delhi, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  url: "https://astroapi-4.divineapi.com/western-api/v1/moon-phase-calendar",
  method: "POST",
  timeout: 0,
  headers: {
    "Authorization": "Bearer {Your Auth Token}"
  },
  processData: false,
  mimeType: "multipart/form-data",
  contentType: false,
  data: form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-4.divineapi.com/western-api/v1/moon-phase-calendar"

payload = {
    'api_key': '{Your API Key}',
    'month': '04',
    'year': '2025',
    'place': 'New Delhi, India',
    'lat': '28.7041',
    'lon': '77.1025',
    'tzone': '5.5',
    'lan': 'en'
}

headers = {
    'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)