Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Lunar → Events

AI-generated

Summary

Calculate lunar events (phases, void-of-course periods, and mansions) for a specified date and location, extending forward by a configurable number of days.

Inputs

  • year (required) — Year for calculation (e.g., 2024). Default: 2024.
  • month (required) — Month as number 1-12 (January=1, December=12). Default: 1, min: 1, max: 12.
  • day (required) — Day of month (1-31). Default: 1, min: 1, max: 31.
  • hour (required) — Hour in 24-hour format (0-23). Default: 12, min: 0, max: 23.
  • minute (required) — Minute (0-59). Default: 0, min: 0, max: 59.
  • locationType (required) — Choose how to specify location: city (coordinates auto-detected) or coordinates (exact latitude/longitude). Default: city.
  • city (required) — City name (e.g., 'London', 'New York'). Required when locationType is city. Default: empty string.
  • countryCode (required) — 2-letter ISO country code (e.g., US, GB, UA). Required when locationType is city. Default: empty string.
  • latitude (required) — Geographic latitude (-90 to 90, positive=North). Required when locationType is coordinates. Default: 0, min: -90, max: 90.
  • longitude (required) — Geographic longitude (-180 to 180, positive=East). Required when locationType is coordinates. Default: 0, min: -180, max: 180.
  • timezone — IANA timezone identifier (e.g., America/New_York, Europe/London). Optional; auto-detected from coordinates if omitted. Default: empty string.
  • daysAhead — Number of days to calculate ahead (1-365). Default: 30, min: 1, max: 365.
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata. Default: true.

Output shape

Lunar event data for the date range starting at the specified datetime, extending daysAhead days forward.

When simplify is enabled (default), returns a condensed response with key event data only. When disabled, returns the full API response including all metadata.

Links

Discussion