curl -X GET "https://api.freeastroapi.com/api/v1/moon/phase?date=2024-01-01T12:00:00&include_visuals=true&include_zodiac=true&include_interpretation=true&include_traditional_moon=true" \
 -H "x-api-key: YOUR_API_KEY"

{
  // Always returned:
  "timestamp": "2024-01-01T12:00:00Z",
  "phase": {
    "name": "Waning Gibbous",
    "phase_angle_deg": 241.36,
    "illumination": 0.785,
    "age_days": 19.4,
    "distance_km": 384400,
    "is_waxing": false
  },
  "next_phases": {
    "new_moon": "2024-01-11T11:57:00Z",
    "first_quarter": "2024-01-24T13:28:00Z",
    "full_moon": "2024-01-25T17:54:00Z",
    "last_quarter": "2024-02-02T23:18:00Z"
  },
  
  // Only when include_zodiac=true:
  "zodiac": {
    "sign": "Leo",
    "sign_id": "leo",
    "degree": 15.42,
    "zodiac_type": "tropical"
  },
  
  // Only when include_visuals=true:
  "moon_visual": {
    "type": "svg",
    "svg": "<svg>...</svg>",
    "shadow_ratio": 0.215,
    "waxing": false
  },
  
  // Only when include_special=true:
  "special_moon": {
    "is_supermoon": true,
    "is_micromoon": false,
    "is_blue_moon": false,
    "is_black_moon": false,
    "is_harvest_moon": false,
    "is_hunter_moon": false,
    "labels": ["Supermoon"]
  },
  
  // Detailed fields populate when include_eclipse=true and an eclipse is within 15 days:
  "eclipse": {
    "is_eclipse": true,
    "is_blood_moon": false,
    "kind": "solar",
    "type": "total",
    "date": "2026-08-12T17:45:59Z",
    "starts_at": "2026-08-12T15:34:33Z",
    "ends_at": "2026-08-12T19:57:58Z",
    "central_phase_starts_at": "2026-08-12T16:58:09Z",
    "central_phase_ends_at": "2026-08-12T18:34:00Z",
    "days_from_query": 0.0,
    "magnitude": 1.0395,
    "obscuration": 1.0,
    "maximum_location": {
      "lat": 65.1653,
      "lon": -25.1048
    },
    "visible_at_location": true,
    "type_at_location": "partial",
    "local_starts_at": "2026-08-12T17:22:13Z",
    "local_maximum_at": "2026-08-12T18:17:19Z",
    "local_ends_at": "2026-08-12T19:09:26Z",
    "magnitude_at_location": 0.9309,
    "obscuration_at_location": 0.921
  },
  
  // Only when include_forecast=true:
  "forecast": {
    "days_until_full_moon": 24.8,
    "days_until_new_moon": 10.8,
    "next_special_moon": {
      "type": "Supermoon",
      "subtype": "new",
      "days_until": 99.5
    },
    "next_eclipse": {
      "kind": "lunar",
      "type": "total",
      "is_blood_moon": true,
      "date": "2026-03-03T11:33:00Z",
      "days_until": 24.8
    },
    "next_solar_eclipse": {
      "kind": "solar",
      "type": "annular",
      "is_blood_moon": false,
      "date": "2026-02-17T12:11:54Z",
      "days_until": 10.8,
      "magnitude": 0.9638,
      "obscuration": 0.9288,
      "maximum_location": {
        "lat": -64.6838,
        "lon": 87.0517
      }
    }
  },

  // Only when include_interpretation=true:
  "interpretation": {
    "key": "planet.moon.sign.scorpio.phase.waning_gibbous.decan.3",
    "title": "Moon in Scorpio | Waning Gibbous | 3rd Decan",
    "body": "In practical inner work, this placement emphasizes depth, loyalty, and transformative feeling states. With Moon in Scorpio, 3rd decan, expression often takes the form of compassionate surrender, while the pressure point is martyr dynamics. During the Waning Gibbous, momentum sits in integration, so the useful move is to distill the lesson and share it with humility. One reliable devotional discipline is to release what is not yours to carry.",
    "tone": "improved",
    "tags": ["moon", "scorpio", "waning_gibbous", "decan_3", "water", "fixed", "psychological", "spiritual"]
  },

  // Only when include_traditional_moon=true:
  "traditional_moon": {
    "name": "Wolf Moon",
    "naming_system": "north_american_traditional",
    "month": "January",
    "applies_to_full_moon_at": "2024-01-25T17:54:00Z",
    "is_current_full_moon": false
  }
}