Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Analysis → Natal Report

AI-generated

Summary

Generate a detailed astrological natal report based on the subject's birth date, time, and location data, optionally including aspect pattern detection and presented in multiple astrological traditions and languages.

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) — Specifies how birth location is provided: 'City Name' or exact 'Coordinates'.
  • city — Birth city name (e.g., "London", "New York", "Kyiv"), required if locationType is 'City Name'.
  • countryCode — 2-letter ISO country code for the birth city (e.g., US, GB, UA), required if locationType is 'City Name'.
  • latitude — Geographic latitude in decimal degrees (-90 to 90, positive=North), required if locationType is 'Coordinates'.
  • longitude — Geographic longitude in decimal degrees (-180 to 180, positive=East), required if locationType is 'Coordinates'.
  • tradition (required) — Astrological tradition to use for the report, such as Universal, Classical, Psychological, Event Oriented, Vedic, or Chinese.
  • language (required) — Language for the response text and interpretations (e.g., English, Russian, German, Spanish).
  • includeAspectPatterns — Boolean flag to include aspect pattern detection (e.g., Grand Trine, T-Square, Yod, Stellium) in the report.
  • simplify — Boolean flag to return a simplified report containing key data only; disabling returns the full API response with all metadata.

Output shape

A JSON object containing the natal astrological report data for the person described by the birth details, possibly simplified or detailed depending on the simplify parameter.

The output contains an astrological natal report that reflects the specified astrological tradition and language. If 'includeAspectPatterns' is true, aspect pattern information is included. The 'simplify' parameter controls whether the response includes only key summary fields or the full detailed API response.

Examples

Example 1: Generate a natal report for a birth occurring on January 15, 1990, at 14:30 in London, GB, using the Universal tradition and English language with aspect patterns included and simplified output.

Set year=1990, month=1, day=15, hour=14, minute=30; locationType='city' with city='London' and countryCode='GB'; tradition='universal'; language='en'; includeAspectPatterns=true; simplify=true.

Links

Discussion