Moon Phase API Documentation

// Fetch current moon phase
fetch('https://api.phaseofthemoontoday.com/v1/current')
  .then(response => response.json())
  .then(data => {
    console.log(`Current phase: ${data.phase}`);
    console.log(`Illumination: ${data.illumination}%`);
  });

// Get moon phase for specific date
const date = '2025-07-20';
fetch(`https://api.phaseofthemoontoday.com/v1/date/${date}`)
  .then(response => response.json())
  .then(data => {
    console.log(`Phase on ${date}: ${data.phase}`);
  });

import requests

# Get current moon phase
response = requests.get('https://api.phaseofthemoontoday.com/v1/current')
data = response.json()

print(f"Current phase: {data['phase']}")
print(f"Illumination: {data['illumination']}%")

# Get historical data
date = '2025-07-20'
response = requests.get(f'https://api.phaseofthemoontoday.com/v1/date/{date}')
data = response.json()

print(f"Phase on {date}: {data['phase']}")

<?php
// Get current moon phase
$url = 'https://api.phaseofthemoontoday.com/v1/current';
$response = file_get_contents($url);
$data = json_decode($response, true);

echo "Current phase: " . $data['phase'] . "\n";
echo "Illumination: " . $data['illumination'] . "%\n";

// Get moon phase for location
$city = 'london';
$url = "https://api.phaseofthemoontoday.com/v1/location/$city";
$response = file_get_contents($url);
$data = json_decode($response, true);

echo "Phase in $city: " . $data['phase'] . "\n";
?>

# Get current moon phase
curl -X GET "https://api.phaseofthemoontoday.com/v1/current" \
     -H "Accept: application/json"

# Get historical moon phase
curl -X GET "https://api.phaseofthemoontoday.com/v1/date/2025-07-20" \
     -H "Accept: application/json"

# Get monthly calendar
curl -X GET "https://api.phaseofthemoontoday.com/v1/calendar/2025-01" \
     -H "Accept: application/json"