Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Analysis → Natal Transit Report

AI-generated

Summary

Calculate a natal transit report analyzing astrological transits over a specified date range based on a person's birth data and a transit date and location. Returns astrological insights comparing natal chart data with transit influences for the selected period.

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) — Specify birth location type: 'City Name' (automatically detected coordinates) or 'Coordinates' (latitude and longitude)
  • city (required) — Birth city name (required if locationType is 'City Name')
  • countryCode (required) — 2-letter ISO country code of birth city (required if locationType is 'City Name')
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North; required if locationType is 'Coordinates')
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East; required if locationType is 'Coordinates')
  • transitYear (required) — Year for the transit calculation
  • transitMonth (required) — Month for the transit calculation (1-12)
  • transitDay (required) — Day for the transit calculation (1-31)
  • transitHour (required) — Hour for the transit calculation in 24-hour format (0-23)
  • transitMinute (required) — Minute for the transit calculation (0-59)
  • transitLocationType (required) — Specify transit location type: 'City Name' (coordinates auto-detected) or 'Coordinates' (latitude and longitude)
  • transitCity (required) — City for transit calculation (required if transitLocationType is 'City Name')
  • transitCountryCode (required) — 2-letter ISO country code for the transit location (required if transitLocationType is 'City Name')
  • transitLatitude (required) — Latitude for transit location (-90 to 90, required if transitLocationType is 'Coordinates')
  • transitLongitude (required) — Longitude for transit location (-180 to 180, required if transitLocationType is 'Coordinates')
  • startDate (required) — Start date for transit analysis period (YYYY-MM-DD)
  • endDate (required) — End date for transit analysis period (YYYY-MM-DD)
  • tradition (required) — Astrological tradition to use for analysis (e.g., Universal, Classical, Psychological, Event Oriented, Vedic, Chinese)
  • language (required) — Language for response text and interpretations
  • includeAspectPatterns — Optionally include aspect pattern detection such as Grand Trine, T-Square, Yod, Stellium, etc.
  • simplify — Optionally simplify response to key data only; disable to receive full API response with metadata

Output shape

a single JSON object representing the natal transit analysis report

The response includes astrological transit information for the person’s natal chart over the specified date range at the specified transit location and time, in the chosen tradition and language. If 'simplify' is enabled, the output returns key summarized data; otherwise, full detailed data with metadata is provided.

Examples

Example 1: Generate a natal transit report for a person born in London, UK on June 15, 1990 at 14:30, analyzing transits for January 1 to December 31, 2024 at the same location.

Provide exact birth date and time, specify birth location by city and country code, set transit date range and transit location accordingly, choose 'Universal' tradition and 'English' language, optionally include aspect patterns, and set simplify to true or false based on desired detail.

Links

Discussion