Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Traditional → Dignities

AI-generated

Summary

Calculate traditional Hellenistic planetary dignities for a natal chart.

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)
  • locationType (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)
  • countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR)
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North)
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East)
  • includeAsteroids — Whether to include asteroid positions in the analysis
  • includeFixedStars — Whether to include fixed star analysis
  • dignitySystem — Dignity calculation system to use
  • majorAspectsOrb — Orb in degrees for major aspects (0.5-10)
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.

Output shape

Planet-dignity mappings keyed by planet, each entry indicating rulership, exaltation, detriment, or fall status; optionally augmented with asteroid and fixed star positions based on includeAsteroids and includeFixedStars flags.

When simplify is true (default), returns key data only; when disabled, returns the full API response with all metadata.

Examples

Example 1: Basic dignity calculation for 1990-06-15 14:30 in London, GB

year=1990, month=6, day=15, hour=14, minute=30, locationType=city, city=London, countryCode=GB, dignitySystem=traditional, simplify=true

Links

Discussion