Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Data → House Cusps

AI-generated

Summary

Calculate the astrological house cusps for a given birth date and time at a specified location, returning either a simplified key-data response or the full API response.

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) — Method to specify birth location: by city name (auto-detects coordinates) or by exact latitude/longitude.
  • City (required) — Birth city name if Location Type is 'City Name' (e.g., "London", "New York", "Kyiv").
  • Country Code (required) — 2-letter ISO country code for the birth city if Location Type is 'City Name' (e.g., US, GB, UA, DE, FR).
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) if Location Type is 'Coordinates'.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) if Location Type is 'Coordinates'.
  • Simplify — Toggle to return simplified response with key data only (true), or full API response with all metadata (false). Default is true.

Output shape

a single response object containing the house cusps data for the specified birth datetime and location

The response can be simplified (default) or full depending on the Simplify input; nested and detailed metadata is included only in the full response.

Examples

Example 1: Calculate house cusps for birth date 1990-06-15 14:30 in London, GB using city name with simplified output

Year=1990, Month=6, Day=15, Hour=14, Minute=30, Location Type=City Name, City=London, Country Code=GB, Simplify=true

Links

Discussion