Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Lunar → Void-of-Course

AI-generated

Summary

Calculates the Moon's void-of-course periods for a given datetime and location, looking ahead a specified number of days.

Inputs

  • Year (required) — Year for calculation (e.g., 2024).
  • Month (required) — Month as number 1-12 (January=1, December=12).
  • Day (required) — Day of month (1-31).
  • Hour (required) — Hour in 24-hour format (0-23).
  • Minute (required) — Minute (0-59).
  • Location Type (required) — Choose how to specify location (City Name or Coordinates).
  • City (required) — City name (e.g., 'London', 'New York'). Required when Location Type is City Name.
  • Country Code (required) — 2-letter ISO country code (e.g., US, GB, UA). Required when Location Type is City Name.
  • Latitude (required) — Geographic latitude (-90 to 90, positive=North). Required when Location Type is Coordinates.
  • Longitude (required) — Geographic longitude (-180 to 180, positive=East). Required when Location Type is Coordinates.
  • Timezone — IANA timezone identifier (e.g., America/New_York, Europe/London). Optional when Location Type is Coordinates; auto-detected if omitted.
  • Days Ahead (required) — Number of days to calculate ahead (1-365). Default 30.
  • Use Modern Planets — Whether to include Uranus, Neptune, and Pluto in void-of-course calculations. Traditional uses only Sun through Saturn. Default false.
  • Simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata. Default true.

Output shape

array of objects (or object if Simplify true). Each object contains void-of-course period details such as start, end, and moon sign. When Simplify is enabled, only essential fields are returned.

The operation returns void-of-course periods for the Moon over the requested period. If Simplify is false, the full API response with additional metadata is provided.

Examples

Example 1: Get the next 30 days of void-of-course periods for London, GB using traditional planets.

Year=2024, Month=6, Day=15, Hour=12, Minute=0, Location Type=City Name, City=London, Country Code=GB, Days Ahead=30, Use Modern Planets=false, Simplify=true

Links

Discussion