Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Analysis → Lunar Return Report

AI-generated

Summary

Generate a monthly Lunar Return report based on the subject's birth date, time, and location, delivering astrological insights in a selected tradition and language.

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990).
  • Month (required) — Birth month as number 1-12 (January=1, December=12).
  • Day (required) — Birth day of month (1-31).
  • Hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon).
  • Minute (required) — Birth minute (0-59).
  • Location Type (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude.
  • City (required) — Birth city name (e.g., "London", "New York", "Kyiv"); required if Location Type is 'City Name'.
  • Country Code (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR); required if Location Type is 'City Name'.
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North); required if Location Type is 'Coordinates'.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East); required if Location Type is 'Coordinates'.
  • Tradition (required) — Astrological tradition to use for the analysis (e.g., Universal, Classical, Psychological, Event Oriented, Vedic, Chinese).
  • Language (required) — Language for response text and interpretations (e.g., English, Russian, German, Spanish, French, Italian, Portuguese, Chinese, Japanese, Korean).
  • Include Aspect Patterns — Toggle to include aspect pattern detection such as Grand Trine, T-Square, Yod, Stellium, etc.
  • Simplify — Toggle to return a simplified response with key data only; disable to receive the full API response with all metadata.

Output shape

a single object representing the lunar return report containing astrological insights, textual interpretations, and optionally detected aspect patterns based on the input birth data and selected options.

The output format may be either simplified (key data only) or full (with metadata) depending on the 'Simplify' input toggle. Language and tradition selections affect the style and language of the interpretations. Aspect pattern inclusion is optional and may add additional detail to the report.

Examples

Example 1: Generate a lunar return report for a subject born on June 15, 1990, at 14:30 in New York, USA, using the Classical astrological tradition in English and including aspect patterns with simplified output.

Year=1990, Month=6, Day=15, Hour=14, Minute=30, Location Type=City Name, City='New York', Country Code='US', Tradition=Classical, Language=en, Include Aspect Patterns=true, Simplify=true

Example 2: Generate a detailed lunar return report for a subject born at specific coordinates in London, UK, in the Vedic tradition, with full API response and without aspect patterns.

Year=1980, Month=1, Day=1, Hour=12, Minute=0, Location Type=Coordinates, Latitude=51.5074, Longitude=-0.1278, Tradition=Vedic, Language=en, Include Aspect Patterns=false, Simplify=false

Links

Discussion